home *** CD-ROM | disk | FTP | other *** search
/ CD ROM Paradise Collection 4 / CD ROM Paradise Collection 4 1995 Nov.iso / comms / cs_v100.zip / COMSHARE.DOC next >
Text File  |  1994-09-15  |  268KB  |  5,526 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.                ╒═══╕               ╒═══╕  │                       (TM)
  13.                │      ╒══╕  ╒═╤═╕  ╘═══╕  ╞══╕   ══╕  ╒══╕  ╒══╕
  14.           ═══  │      │  │  │ │ │      │  │  │  ╒══╡  │     ╞══╛  ═══
  15.                ╘═══╛  ╘══╛  ┘ ┴ └  ╘═══╛  ┴  ┴  ╘══╛  ┴     ╘══
  16.  
  17.                  Telecommunications Resource Management System
  18.  
  19.                     for NetBIOS & Novell Local Area Networks
  20.  
  21.  
  22.  
  23.                                   Version 1.00
  24.  
  25.                               September 15th, 1994
  26.  
  27.  
  28.  
  29.                              By David A. Stephenson
  30.  
  31.  
  32.  
  33.  
  34.  
  35.                              - Operations Manual -
  36.                                =================
  37.  
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.          Copyright (c) 1994 David A. Stephenson & NashaKala Corporation
  45.  
  46.  
  47.                          All rights reserved worldwide.
  48.  
  49.  
  50.  
  51.     THE COMSHARE SYSTEM                                 TABLE OF CONTENTS    i
  52.  
  53.  
  54.  
  55.     TABLE OF CONTENTS
  56.     ══════════════════════════════════════════════════════════════════════════
  57.  
  58.  
  59.     INTRODUCTION                                                             1
  60.         Do You Have a Tampered Copy ? . . . . . . . . . . . . . . . . . . .  1
  61.         How The ComShare System Works . . . . . . . . . . . . . . . . . . .  2
  62.         Is This Software Right For You ?  . . . . . . . . . . . . . . . . .  4
  63.         The Benefits of Using the ComShare System . . . . . . . . . . . . .  5
  64.         How Much of This Documentation Should I Read ?  . . . . . . . . . .  5
  65.  
  66.     GETTING STARTED                                                          7
  67.         Minimum System Requirements . . . . . . . . . . . . . . . . . . . .  7
  68.         How The ComShare System is Distributed  . . . . . . . . . . . . . .  9
  69.         Creating The Registered Version . . . . . . . . . . . . . . . . . . 10
  70.         Creating The Tryware Version  . . . . . . . . . . . . . . . . . . . 10
  71.         The PICKCOM.EXE Program . . . . . . . . . . . . . . . . . . . . . . 11
  72.         Setting Up Your System  . . . . . . . . . . . . . . . . . . . . . . 12
  73.         Theory & Nomenclature . . . . . . . . . . . . . . . . . . . . . . . 12
  74.         Online Help . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13
  75.  
  76.     THE TERMS OF USAGE                                                      15
  77.         Copyright . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15
  78.         The Tryware License . . . . . . . . . . . . . . . . . . . . . . . . 15
  79.         Disclaimer  . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15
  80.         Trademarks  . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16
  81.  
  82.     THE INSTALL PROGRAM                                                     17
  83.         What The INSTALL Program Does . . . . . . . . . . . . . . . . . . . 17
  84.         Starting The INSTALL Program  . . . . . . . . . . . . . . . . . . . 17
  85.         How The INSTALL Program Works . . . . . . . . . . . . . . . . . . . 18
  86.         The INSTALL Program's Menus . . . . . . . . . . . . . . . . . . . . 18
  87.         The INSTALL Program's Data Entry Screens  . . . . . . . . . . . . . 19
  88.         The INSTALL Program's Main Menu . . . . . . . . . . . . . . . . . . 23
  89.         Creating The ComShare System Kernel . . . . . . . . . . . . . . . . 24
  90.         The ComShare System Order Form  . . . . . . . . . . . . . . . . . . 27
  91.         Filling Out The Order Form  . . . . . . . . . . . . . . . . . . . . 28
  92.             Claiming the Previous Purchase Deduction  . . . . . . . . . . . 28
  93.             Filling In The Licensee Information . . . . . . . . . . . . . . 30
  94.             Filling In The Order Information  . . . . . . . . . . . . . . . 31
  95.             Choosing The Licensee Identification  . . . . . . . . . . . . . 31
  96.             Specifying The Network Type . . . . . . . . . . . . . . . . . . 34
  97.         Printing Out The Order Form . . . . . . . . . . . . . . . . . . . . 34
  98.  
  99.     MAKING A COM PORT SHAREABLE                                             36
  100.         The SHARECOM Program  . . . . . . . . . . . . . . . . . . . . . . . 36
  101.         Memory Considerations . . . . . . . . . . . . . . . . . . . . . . . 37
  102.         Opening A Com Port  . . . . . . . . . . . . . . . . . . . . . . . . 38
  103.             The "/OPEN" Command Line Option . . . . . . . . . . . . . . . . 38
  104.             The "/ADDR" Command Line Option . . . . . . . . . . . . . . . . 39
  105.             The "/IRQ" Command Line Option  . . . . . . . . . . . . . . . . 39
  106.             The "/GRAD" Command Line Option . . . . . . . . . . . . . . . . 40
  107.             The "/FLOW" Command Line Option . . . . . . . . . . . . . . . . 40
  108.             The "/PASS" Command Line Option . . . . . . . . . . . . . . . . 42
  109.             The "/TEXT" Command Line Option . . . . . . . . . . . . . . . . 42
  110.         Closing A Com Port  . . . . . . . . . . . . . . . . . . . . . . . . 43
  111.  
  112.     THE COMSHARE SYSTEM                                 TABLE OF CONTENTS   ii
  113.  
  114.  
  115.  
  116.             The "/CLOSE" Command Line Option  . . . . . . . . . . . . . . . 43
  117.         Ascertaining The Status . . . . . . . . . . . . . . . . . . . . . . 44
  118.             The "/STATUS" Command Line Option . . . . . . . . . . . . . . . 44
  119.         Other Options . . . . . . . . . . . . . . . . . . . . . . . . . . . 46
  120.             The "/LOAD" Command Line Option . . . . . . . . . . . . . . . . 46
  121.             The "/GUARD" Command Line Option  . . . . . . . . . . . . . . . 46
  122.             The "/DISABLE" Command Line Option  . . . . . . . . . . . . . . 47
  123.             The "/SHUTDOWN" Command Line Option . . . . . . . . . . . . . . 47
  124.  
  125.     USING A SHAREABLE COM PORT                                              48
  126.         The USECOM Program  . . . . . . . . . . . . . . . . . . . . . . . . 48
  127.         Memory Considerations . . . . . . . . . . . . . . . . . . . . . . . 49
  128.         Opening A Com Port  . . . . . . . . . . . . . . . . . . . . . . . . 50
  129.             The "/OPEN" Command Line Option . . . . . . . . . . . . . . . . 51
  130.             The "/START" Command Line Option  . . . . . . . . . . . . . . . 51
  131.             The "/GRAD" Command Line Option . . . . . . . . . . . . . . . . 52
  132.             The "/PASS" Command Line Option . . . . . . . . . . . . . . . . 52
  133.         Closing A Com Port  . . . . . . . . . . . . . . . . . . . . . . . . 52
  134.             The "/CLOSE" Command Line Option  . . . . . . . . . . . . . . . 53
  135.         Ascertaining The Status . . . . . . . . . . . . . . . . . . . . . . 53
  136.             The "/STATUS" Command Line Option . . . . . . . . . . . . . . . 54
  137.         Other Options . . . . . . . . . . . . . . . . . . . . . . . . . . . 56
  138.             The "/LOAD" Command Line Option . . . . . . . . . . . . . . . . 56
  139.             The "/BUFFER" Command Line Option . . . . . . . . . . . . . . . 56
  140.             The "/RELEASE" Command Line Option  . . . . . . . . . . . . . . 57
  141.             The "/SHUTDOWN" Command Line Option . . . . . . . . . . . . . . 57
  142.  
  143.     THE PICKCOM PROGRAM                                                     58
  144.         What The PICKCOM Program Does . . . . . . . . . . . . . . . . . . . 58
  145.         Starting The PICKCOM Program  . . . . . . . . . . . . . . . . . . . 58
  146.         How The PICKCOM Program Works . . . . . . . . . . . . . . . . . . . 59
  147.         The PICKCOM Program's Main Menu . . . . . . . . . . . . . . . . . . 60
  148.         Opening A Com Port With PICKCOM . . . . . . . . . . . . . . . . . . 61
  149.         Closing A Com Port With PICKCOM . . . . . . . . . . . . . . . . . . 64
  150.  
  151.     REGISTRATION                                                            65
  152.         The Registered Licenses . . . . . . . . . . . . . . . . . . . . . . 66
  153.         Ordering A Registered License . . . . . . . . . . . . . . . . . . . 67
  154.         NashaKala Corporation's Upgrade Policy  . . . . . . . . . . . . . . 67
  155.  
  156.     APPENDIX A: USING THE COMSHARE SYSTEM WITH TELEMATE                     69
  157.         Setting Up TeleMate To Use a GRAD . . . . . . . . . . . . . . . . . 69
  158.         Setting Up The GRAD To Use With TeleMate  . . . . . . . . . . . . . 70
  159.         Using TeleMate With a GRAD  . . . . . . . . . . . . . . . . . . . . 71
  160.  
  161.     APPENDIX B: USING THE COMSHARE SYSTEM WITH WINDOWS 3.1                  73
  162.  
  163.     APPENDIX C: THE COMSHARE SYSTEM API FOR PROGRAMMERS                     75
  164.  
  165.     APPENDIX D: TROUBLESHOOTING                                             83
  166.  
  167.     APPENDIX E: ERROR MESSAGES                                              88
  168.         SHARECOM Error Messages . . . . . . . . . . . . . . . . . . . . . . 88
  169.         USECOM Error Messages . . . . . . . . . . . . . . . . . . . . . . . 93
  170.         PICKCOM Error Messages  . . . . . . . . . . . . . . . . . . . . . . 96
  171.         INSTALL Error Messages  . . . . . . . . . . . . . . . . . . . . . . 97
  172.  
  173.     THE COMSHARE SYSTEM                                      INTRODUCTION    1
  174.  
  175.  
  176.  
  177.     INTRODUCTION
  178.     ══════════════════════════════════════════════════════════════════════════
  179.  
  180.  
  181.     The ComShare System was created for one purpose: to enable the sharing
  182.     of ordinary modems across any NetBIOS or Novell-compatible Local Area
  183.     Network, in much the same way as printers are currently being shared in
  184.     the average network configuration.
  185.  
  186.     So what does it mean to "share" a modem, and why would anyone want to
  187.     do that ?
  188.  
  189.     Well, to begin with, "sharing" a modem means to make it "shareable"
  190.     across a network.  Once something is made "shareable" across a network,
  191.     it means that everyone logged onto the network will be able to use it
  192.     if they so desire.  In other words, to "share" a single modem on a
  193.     network is just another way of saying that everyone on the network
  194.     will have access to it if they want to use it, even though it may be
  195.     physically located on someone else's machine.
  196.  
  197.     And the reason why anyone would want to share modems on a network is
  198.     basically the same reason why printers are normally shared on a network:
  199.     cost effectiveness (saving money!).
  200.  
  201.     Say, for example, that there are 50 people (or nodes, if you prefer)
  202.     on a network, and they all require (or would like) access to a modem.
  203.     One solution would be to simply go out and BUY 50 modems, one for each
  204.     machine, and at about $250 per modem (at the time of this writing), that
  205.     would only cost you about $12,500 (plus tax)...
  206.  
  207.     On the other hand, if you only bought TEN modems, which would cost you
  208.     $2500, and the 10-Port License of the ComShare System, which costs $60,
  209.     you would still be providing modem access for all 50 people, but your
  210.     total cost would only be $2,560 !
  211.  
  212.     You would therefore save approximately $10,000 on the price of the
  213.     modems alone...
  214.  
  215.     ...not to mention the cost of the 40 extra phone lines you wouldn't
  216.     have to pay for...                                         ~~~~~~~~
  217.  
  218.  
  219.     Do You Have a Tampered Copy ?
  220.     ─────────────────────────────
  221.  
  222.     The ComShare System is distributed as an "Author Verified" .ZIP file,
  223.     known as the "distribution .ZIP file", whose name will be of the form,
  224.     "CS_Vxxx.ZIP", where the "xxx" part of the name will be three numeric
  225.     digits representing the current version number of the program, as in
  226.     "CS_V100.ZIP" for version 1.00 of the ComShare System.
  227.  
  228.     The term "Author Verified" means that when you "unzip" it using the
  229.     PKZIP program, you should see an "-AV" appear after the name of every
  230.     file extracted.
  231.  
  232.     THE COMSHARE SYSTEM                                      INTRODUCTION    2
  233.  
  234.  
  235.  
  236.     You should also see the following appear on your screen once all the
  237.     files have been extracted:
  238.  
  239.     Authentic files Verified!   # KCS094
  240.     NashaKala Corporation
  241.     P.O. Box 218
  242.     Station 'K'
  243.     Toronto, Ontario  CANADA
  244.     M4P-2E0
  245.  
  246.     If you did not see ALL of the above notices appear on your screen in
  247.     the order indicated upon extraction, then you have a tampered copy, and
  248.     you should, for your own protection, delete it, and report the incident
  249.     to whatever source provided you with that copy.
  250.  
  251.     The files that should be created after extraction are:
  252.  
  253.     File Name         File Size         Description
  254.     ~~~~~~~~~         ~~~~~~~~~         ~~~~~~~~~~~
  255.  
  256.     README.1ST       14,116 bytes       Introduction
  257.     COMSHARE.DOC    268,488 bytes       This file
  258.     INSTALL.EXE     181,887 bytes       The ComShare System Install program
  259.     PICKIPX.EXE      44,174 bytes       PICKCOM.EXE for Novell Networks
  260.     PICKNETB.EXE     43,598 bytes       PICKCOM.EXE for NetBIOS Networks
  261.  
  262.     DESC.SDI            469 bytes       BBS description blurb - deletable
  263.     FILE_ID.DIZ         469 bytes       BBS description blurb - deletable
  264.  
  265.  
  266.     If all of the above files were not created after extraction, or if any
  267.     were created with different sizes than those listed, you probably have
  268.     a tampered copy.
  269.  
  270.  
  271.     How The ComShare System Works
  272.     ─────────────────────────────
  273.  
  274.     The operational part of the ComShare System consists of three executables,
  275.     or programs, which are:
  276.  
  277.     SHARECOM.COM  -  This is the program that makes a single modem, or,
  278.     ~~~~~~~~~~~~     to be more exact, a single Com Port, "shareable" on
  279.                      the network.
  280.  
  281.                      It *is* a TSR, and will therefore leave a piece of
  282.                      itself in memory every time it successfully makes a
  283.                      modem shareable (something like the DOS "mode" command).
  284.  
  285.                      Only nine kilobytes (9K) of memory is required to
  286.                      share a single modem however, and only an additional
  287.                      two to three kilobytes (2-3K) of memory, depending on
  288.                      the type of network, is required after that to share
  289.                      each additional modem on the same machine.
  290.  
  291.     THE COMSHARE SYSTEM                                      INTRODUCTION    3
  292.  
  293.  
  294.  
  295.                      Up to four modems on a single machine can be made
  296.                      shareable.
  297.  
  298.     USECOM.COM  -  This is the program that serves to either "connect" to,
  299.     ~~~~~~~~~~     or "disconnect" from, any modem (or Com Port) on the
  300.                    network that was previously made shareable by
  301.                    SHARECOM.COM.
  302.  
  303.                    It is also a TSR (Terminate but Stay Resident) type
  304.                    of program, but requires only six kilobytes (6K) of
  305.                    resident memory to "connect" to a single shareable modem.
  306.  
  307.                    Once a shareable modem has been "connected" to in this
  308.                    way, it is no longer accessible to anyone except the
  309.                    machine it is "connected" to, and remains inaccessible
  310.                    until USECOM.COM is used to "disconnect" from it.
  311.  
  312.                    Up to four simultaneous "connections" can be established
  313.                    on a single machine, but concurrent connections on a
  314.                    single machine are rarely used. (but who knows?)
  315.  
  316.     PICKCOM.EXE  -  This program is the "User Friendly" version of the
  317.     ~~~~~~~~~~~     "USECOM.COM" program described above, whose sole
  318.                     purpose is to gather the information required by the
  319.                     "USECOM.COM" program, and then proceed to invoke it
  320.                     once all the requisite information has been gathered.
  321.  
  322.                     It is completely menu-driven and includes full mouse
  323.                     support (so you can use a mouse if you have one).
  324.  
  325.                     It does, however, do something that the "USECOM.COM"
  326.                     program does not, which is to search the entire
  327.                     network for available, unconnected shareable modems,
  328.                     the composite list of which is then presented to the
  329.                     User (ie: you) as a menu of possible "connections"
  330.                     that can be made.
  331.  
  332.     The first two programs listed above, SHARECOM & USECOM, are known
  333.     collectively as the ComShare System's "kernel".
  334.  
  335.     Using these three programs, the steps involved in setting up, then
  336.     using, a single shared modem on any Local Area Network, is as follows:
  337.  
  338.     1)  Physically install the modem as you normally would on any machine
  339.         that is (or can be) connected to the Local Area Network you are using.
  340.         This would involve inserting the card into its slot, setting the
  341.         appropriate dip switches, etc...
  342.  
  343.         You might also make a note here of any non-standard settings you
  344.         might have chosen for your modem, such as the Com Port number,
  345.         the IRQ number, or the (hex) port address (if you changed it).
  346.  
  347.     2)  On the same machine, once it is connected to the network, run the
  348.         SHARECOM.COM program to "Open" the Com Port that the modem was
  349.         installed on (in step 1).
  350.  
  351.     THE COMSHARE SYSTEM                                      INTRODUCTION    4
  352.  
  353.  
  354.  
  355.         "Opening" a Com Port using the SHARECOM.COM program makes the modem
  356.         connected to it "shareable" across the entire Local Area Network.
  357.  
  358.     3)  On any machine that is currently connected to the network, run the
  359.         USECOM.COM program to "Open" a Com Port of your choosing.  The Com
  360.         Port number you choose is completely arbitrary, and need not be the
  361.         same as the Com Port number used in step 2.  The Com Port number
  362.         you choose here, however, will be used in step 4, and should not
  363.         have anything currently attached to it, such as a modem or a mouse.
  364.  
  365.         "Opening" a Com Port using the USECOM.COM program "connects" that
  366.         Com Port to an available "shareable" modem somewhere on the network.
  367.  
  368.         If you do not specify a specific "shareable" modem to connect to,
  369.         USECOM.COM will attempt to connect to the first available "shareable"
  370.         modem that it finds.
  371.  
  372.     4)  On the same machine that USECOM.COM was run on, you are now able to
  373.         run your favorite telecommunications software, which must have been
  374.         previously configured to use the Com Port you chose in step 3.
  375.  
  376.         There is, however, an additional qualification that must be met by
  377.         the telecommunications software you choose to use before it is able
  378.         to communicate effectively with the "shared" modem.
  379.  
  380.         ...Which brings us to the next (rather important) point:
  381.  
  382.  
  383.     Is This Software Right For You ?
  384.     ────────────────────────────────
  385.  
  386.     In order to share modem capabilities across a Local Area Network, the
  387.     ComShare System must rely on the fact that any telecommunications
  388.     package you choose to use can be, or more accurately, will be, set up
  389.     to use the standard EBIOS Com Port interface.
  390.                ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  391.  
  392.     This standard EBIOS Com Port interface is known industry-wide as the
  393.     "INT-14" interface, named after the "software interrupt number" it was
  394.     assigned (14h) when the first IBM PC was created way back in 1980.  Its
  395.     exact definition can be found in APPENDIX C of this documentation.
  396.  
  397.     Regardless of whatever convoluted name was historically chosen to
  398.     represent this interface however, it does remain to this day as the most
  399.     standard way of communicating with a PC's Com Port, without having to
  400.     resort to accessing the physical hardware of the Com Port directly.
  401.  
  402.     Unfortunately however, although the "INT-14h" interface is quite a good
  403.     one, its *implementation* in the standard ROM BIOS has historically
  404.     been rather poor, to the point where most software authors have been
  405.     forced, more out of necessity than anything else, to write software
  406.     which accesses the physical hardware of the Com Port directly.
  407.  
  408.     If that were the end of the story however, the ComShare System would
  409.     never have been written.
  410.  
  411.     THE COMSHARE SYSTEM                                      INTRODUCTION    5
  412.  
  413.  
  414.  
  415.     One of the most powerful and versatile general-purpose telecommunications
  416.     packages in existence today, called "TeleMate", can easily be set up to
  417.     use the "INT-14h" interface.  It is distributed as Shareware, and is
  418.     therefore immediately accessible, it is inexpensive, it has virtually
  419.     ALL the modern file-transfer protocols you'll ever need, a plethora of
  420.     options, and can even operate flawlessly as a background (DOS BOX) task
  421.     under Windows 3.1 (in enhanced mode, of course) !
  422.  
  423.     In conjunction with TeleMate then, Network Modem-Sharing using the
  424.     ComShare System is a breeze.  Details on just such a setup is provided
  425.     in APPENDIX A of this documentation.  It is considered a *MUST READ*
  426.     before working with the TeleMate program however.
  427.  
  428.     TeleMate is normally distributed in compressed form as a set of ".ZIP"
  429.     files under the name, "TMvvv-?.ZIP", where "vvv" is the version number
  430.     (ie: "412" for version 4.12), and the "?" is the ordinal of the set,
  431.     such as "1" for the first file, "2" for the second, etc...
  432.  
  433.     If the telecommunications package you are currently using cannot
  434.     communicate with a Com Port through the "Int 14h" interface therefore,
  435.     you might want to consider switching to one that does, or perhaps
  436.     suggesting to the manufacturer that they include such a capability
  437.     (it is, relatively speaking, a trivial task for them to add it).
  438.  
  439.  
  440.     The Benefits of Using the ComShare System
  441.     ─────────────────────────────────────────
  442.  
  443.     The ComShare System is the fastest, smallest, and least expensive
  444.     Modem-Sharing package in the world to date.  As mentioned previously,
  445.     it requires only 9K of resident memory (1K more for the IPX/SPX version)
  446.     to share a single modem, where other packages may require up to 57K.
  447.     It is the fastest, in that modems can be shared across the network
  448.     virtually without regard for the baud rate the modem is operating at
  449.     (unless a very slow machine is used), and at approximately $3 per modem
  450.     for the 99-Port License, it is definitely the least expensive product
  451.     of its kind in the market today.
  452.  
  453.  
  454.     How Much of This Documentation Should I Read ?
  455.     ──────────────────────────────────────────────
  456.  
  457.     During Beta Testing of this product, one of the Beta Testers described
  458.     this documentation as "voluminous".  Given its scope, I suppose I would
  459.     have to agree.  For those wishing to expedite the time spent perusing
  460.     this documentation therefore, the following general guidelines are
  461.     recommended to save time:
  462.  
  463.     At a minimum, you should read the following before attempting anything
  464.     else:
  465.  
  466.     1)  The entire "GETTING STARTED" section,
  467.  
  468.     2)  As much of the "MAKING A COM PORT SHAREABLE" section as you can,
  469.         especially the first three sub-sections, and
  470.  
  471.     THE COMSHARE SYSTEM                                      INTRODUCTION    6
  472.  
  473.  
  474.  
  475.     3)  As much of the "USING A SHAREABLE COM PORT" section as you can,
  476.         especially the first three sub-sections.
  477.  
  478.     Also, and very important, if you are going to be using the TeleMate
  479.     program with the ComShare System, and for version 1.00 you probably
  480.     will be, it is ABSOLUTELY ESSENTIAL that you read all of APPENDIX A
  481.     before proceeding.
  482.  
  483.     Considerable time can also be saved by reading the section entitled,
  484.     "A QUICK INSTALLATION GUIDE" in the "README.1ST" file, before reading
  485.     any of the above.
  486.  
  487.     And lastly, should you run into any trouble, don't forget that APPENDIX D
  488.     is there to help.
  489.  
  490.     THE COMSHARE SYSTEM                                   GETTING STARTED    7
  491.  
  492.  
  493.  
  494.     GETTING STARTED
  495.     ══════════════════════════════════════════════════════════════════════════
  496.  
  497.  
  498.     Minimum System Requirements
  499.     ───────────────────────────
  500.  
  501.     To run, every program in the ComShare System requires, at a minimum, an
  502.     IBM PC/AT or 100% compatible computer which is running a version of the
  503.     MS-DOS operating system version 3.1 or later.
  504.  
  505.     The following minimum amounts of conventional memory must also be present
  506.     in your system for the following programs to run properly:
  507.  
  508.                     ╔═══════════════╤════════════════╗
  509.                     ║    Program    │  RAM required  ║
  510.                     ╠═══════════════╪════════════════╣
  511.                     ║  INSTALL.EXE  │     240K       ║
  512.                     ╟───────────────┼────────────────╢
  513.                     ║  PICKCOM.EXE  │     110K       ║
  514.                     ╚═══════════════╧════════════════╝
  515.  
  516.     To gauge how much RAM is needed to run either the SHARECOM or USECOM
  517.     programs, simply add about 5K to their file size.
  518.  
  519.     Additionally, except for the generation of help screens, the SHARECOM,
  520.     USECOM, and PICKCOM programs require that your network software be
  521.     previously installed.  If you are running a Novell Network, this means
  522.     that either IPX.COM or IPXODI.COM must have been installed.
  523.  
  524.     The SHARECOM program also requires that it be installed on a machine
  525.     which is fast (or powerful) enough to accommodate the processing involved
  526.     in managing both the network and the shareable modem's traffic, as well
  527.     as any foreground processing it might be involved with at the time.
  528.  
  529.     This latter point can best be illustrated by trying to envision an 8088
  530.     machine, running at 4.77 Mhz, simultaneously sharing four 38,400 baud
  531.     modems across the network, all of which are currently being used at
  532.     maximum capacity to download files, while also calculating the payroll
  533.     for 200 employees.
  534.  
  535.     As you might imagine, no matter how good the software is at that point,
  536.     that poor little 8088 simply won't have the juice to accomplish
  537.     everything it is being asked to do.  Something will have to give.
  538.  
  539.     You therefore don't want to install the SHARECOM program on any machine
  540.     that doesn't have the raw processing power necessary to do the job.
  541.  
  542.     Unfortunately, 'raw processing power' is not an easy thing to gauge.
  543.  
  544.     In an attempt to offer a general guideline however, as to what kind of
  545.     machines represent a reasonable minimum for trouble-free operation of
  546.     the SHARECOM program, the following chart may be used:
  547.  
  548.     THE COMSHARE SYSTEM                                   GETTING STARTED    8
  549.  
  550.  
  551.  
  552.         ╔═══════════╦═══════════════════════════════════════════════╗
  553.         ║ Baud Rate ║   - Number of Com Ports to make Shareable -   ║
  554.         ║ of each   ╠═══════════╦═══════════╦═══════════╦═══════════╣
  555.         ║ Com Port  ║     1     ║     2     ║     3     ║     4     ║
  556.         ╠═══════════╬═══════════╬═══════════╬═══════════╬═══════════╣
  557.         ║ 1200      ║ 286-8Mhz  ║ 286-12Mhz ║ 286-20Mhz ║ 286-25Mhz ║
  558.         ╠═══════════╬═══════════╬═══════════╬═══════════╬═══════════╣
  559.         ║ 2400      ║ 286-20Mhz ║ 286-25Mhz ║ 386-20Mhz ║ 386-25Mhz ║
  560.         ╠═══════════╬═══════════╬═══════════╬═══════════╬═══════════╣
  561.         ║ 9600      ║ 286-25Mhz ║ 386-20Mhz ║ 386-25Mhz ║ 386-25Mhz ║
  562.         ╠═══════════╬═══════════╬═══════════╬═══════════╬═══════════╣
  563.         ║ 14,400    ║ 386-20Mhz ║ 386-25Mhz ║ 486-25Mhz ║ 486-25Mhz ║
  564.         ╠═══════════╬═══════════╬═══════════╬═══════════╬═══════════╣
  565.         ║ 19,200    ║ 386-20Mhz ║ 386-25Mhz ║ 386-33Mhz ║ 386-33Mhz ║
  566.         ╠═══════════╬═══════════╬═══════════╬═══════════╬═══════════╣
  567.         ║ 38,400    ║ 386-25Mhz ║ 386-25Mhz ║ 386-33Mhz ║ 386-33Mhz ║
  568.         ╚═══════════╩═══════════╩═══════════╩═══════════╩═══════════╝
  569.  
  570.     If you plan to share 4 Com Ports at 9600 baud for instance, the minimum
  571.     processing power of the machine you choose to use for the job, according
  572.     to the above chart, should be the equivalent of, or better than, a 386
  573.     machine operating at 25 Mhz.
  574.  
  575.     Keep in mind however, that the above chart is based on the assumption
  576.     that you will also be performing other processing tasks on the machine
  577.     while it is sharing Com Ports in the background.  If you decide that
  578.     you can afford to 'dedicate' a machine to sharing Com Ports only, with-
  579.     out running any significant foreground tasks, then the following chart
  580.     may be used instead:
  581.  
  582.         ╔═══════════╦═══════════════════════════════════════════════╗
  583.         ║ Baud Rate ║   - Number of Com Ports to make Shareable -   ║
  584.         ║ of each   ╠═══════════╦═══════════╦═══════════╦═══════════╣
  585.         ║ Com Port  ║     1     ║     2     ║     3     ║     4     ║
  586.         ╠═══════════╬═══════════╬═══════════╬═══════════╬═══════════╣
  587.         ║ 1200      ║  86-8Mhz  ║  86-12Mhz ║ 286-12Mhz ║ 286-20Mhz ║
  588.         ╠═══════════╬═══════════╬═══════════╬═══════════╬═══════════╣
  589.         ║ 2400      ║ 286-12Mhz ║ 286-20Mhz ║ 286-20Mhz ║ 286-25Mhz ║
  590.         ╠═══════════╬═══════════╬═══════════╬═══════════╬═══════════╣
  591.         ║ 9600      ║ 286-20Mhz ║ 286-25Mhz ║ 286-25Mhz ║ 386-20Mhz ║
  592.         ╠═══════════╬═══════════╬═══════════╬═══════════╬═══════════╣
  593.         ║ 14,400    ║ 286-20Mhz ║ 286-25Mhz ║ 386-20Mhz ║ 386-20Mhz ║
  594.         ╠═══════════╬═══════════╬═══════════╬═══════════╬═══════════╣
  595.         ║ 19,200    ║ 286-25Mhz ║ 286-25Mhz ║ 386-20Mhz ║ 386-20Mhz ║
  596.         ╠═══════════╬═══════════╬═══════════╬═══════════╬═══════════╣
  597.         ║ 38,400    ║ 386-20Mhz ║ 386-20Mhz ║ 386-25Mhz ║ 386-25Mhz ║
  598.         ╚═══════════╩═══════════╩═══════════╩═══════════╩═══════════╝
  599.  
  600.     Also, for both of the above charts, it's quite possible that a lesser
  601.     machine than that specified can be used with no detrimental effects.
  602.     This is due to the myriad number of variables involved, such as how
  603.     well built the machine is, the transfer rate of the network, how many
  604.     Com Ports are being used at a time, etc.  The above charts are based
  605.     (loosely) on simultaneous Com Port usage at their maximum baud rates,
  606.     with machines using 80 ns memory chips.  These estimates should therefore
  607.     be considered on the conservative side.
  608.  
  609.     THE COMSHARE SYSTEM                                   GETTING STARTED    9
  610.  
  611.  
  612.  
  613.     For the Novell-specific versions of the ComShare System, IPX/SPX must be
  614.     installed, and you must also be running a version of the Novell Network
  615.     software no earlier than version 3.11, and/or Diagnostic Support should
  616.     be present on all servers and bridges, or some shareable modems (existing
  617.     across bridges or servers) may not be found even if installed.
  618.  
  619.     Also, although not strictly required, it is recommended that the Novell-
  620.     specific file, "SHELL.CFG" contain one or more of the following lines:
  621.  
  622.     IPX RETRY COUNT = 2
  623.     SPX ABORT TIMEOUT = 7
  624.     ALL SERVERS = ON
  625.  
  626.     In terms of resident memory, the SHARECOM program requires approximately
  627.     seven kilobytes (7K), and the USECOM program requires approximately four
  628.     kilobytes (4K), in addition to the resident memory required for each
  629.     installed Com Port's character buffer, the sizes for which can best be
  630.     illustrated with the following little chart:
  631.  
  632.                            ╔═══════════════════════════════════════╗
  633.        ╔═══════════════════╣      *** Resident Buffer Size ***     ║
  634.        ║  ComShare System  ╠═══════════════════╤═══════════════════╣
  635.        ║      Program      ║  IPX/SPX version  │  NetBIOS version  ║
  636.        ╠═══════════════════╬═══════════════════╪═══════════════════╣
  637.        ║    SHARECOM.COM   ║    3296 bytes     │    2256 bytes     ║
  638.        ╟───────────────────╫───────────────────┼───────────────────╢
  639.        ║    USECOM.COM     ║    3200 bytes     │    2176 bytes     ║
  640.        ╚═══════════════════╩═══════════════════╧═══════════════════╝
  641.  
  642.  
  643.     How The ComShare System is Distributed
  644.     ──────────────────────────────────────
  645.  
  646.     There are two mutually exclusive versions of the ComShare System:
  647.     one for NetBIOS-based networks, known as the "NetBIOS version", and
  648.     one for Novell-based networks, known as the "IPX/SPX version".
  649.  
  650.     Both versions are distributed as TRYWARE.
  651.  
  652.     "Tryware" is a somewhat unique marketing method that allows a potential
  653.     customer the ability the "try" a software product before making the
  654.     decision to buy the License to "use" that software product.
  655.  
  656.     In other words, it allows you to "try before you buy", so that you can
  657.     determine, *before* you spend any actual money, whether the product is
  658.     suitable for your purposes, or not.
  659.  
  660.     Having read thus far, you might be wondering what exactly the difference
  661.     is between "trying" the software, and "using" the software.  I know I
  662.     would be.
  663.  
  664.     For the ComShare System, the difference is quite simple.  There are two
  665.     versions of the product: the "Tryware" version, and the "Registered"
  666.     version.
  667.  
  668.     THE COMSHARE SYSTEM                                   GETTING STARTED   10
  669.  
  670.  
  671.  
  672.     The only functional difference between the two versions is that, in
  673.     the "Tryware" version of the ComShare System, the network connection
  674.     established between the machine *using* a shared modem, and the machine
  675.     on which it is physically located, will only last 30 minutes from the
  676.     time it is initially "connected".  After 30 minutes, the connection will
  677.     be broken, at which point the connection must be re-established by
  678.     running the USECOM program again.
  679.  
  680.     What this means is that, for exactly 30 minutes *at a time*, you are
  681.     able to see for yourself whether or not the ComShare System is, or can
  682.     be, suitable for your purposes, and perhaps more to the point, whether
  683.     or not it is worth buying.
  684.  
  685.     An additional difference between the Tryware and Registered versions of
  686.     the ComShare System is the number of different Licenses that can be
  687.     granted.  In the Tryware version of the software, there is only one
  688.     License which, among other things, only grants you the right to make
  689.     shareable a maximum of two Com Ports on a single network at a time.
  690.  
  691.     There are six different Registered Licenses however, the sole
  692.     differentiating element among them being the maximum number of Com Ports
  693.     you are allowed to make concurrently shareable on a single network.
  694.  
  695.     Because of this, each Registered License is known by how many concurrently
  696.     shareable Com Ports it allows for.  The "5-Port" Registered License grants
  697.     the right to make shareable up to five Com Ports at a time, for example,
  698.     and would obviously cost more than the "2-Port" Registered License, but
  699.     less than the "10-Port" Registered License.
  700.  
  701.     Having said that, the six different Registered Licenses, and their
  702.     respective purchase prices, are:
  703.  
  704.     the  "2-Port"   License :   US $25      ( $12.50 per Com Port )
  705.     the  "5-Port"   License :   US $40      (  $8.00 per Com Port )
  706.     the  "10-Port"  License :   US $60      (  $6.00 per Com Port )
  707.     the  "20-Port"  License :   US $100     (  $5.00 per Com Port )
  708.     the  "50-Port"  License :   US $200     (  $4.00 per Com Port )
  709.     the  "99-Port"  License :   US $300     (  $3.03 per Com Port )
  710.  
  711.     More information about the Registered Licenses of the ComShare System
  712.     can be obtained from the "REGISTRATION" section of this documentation.
  713.  
  714.  
  715.     Creating The Registered Version
  716.     ───────────────────────────────
  717.  
  718.     To create the Registered version of the ComShare System, please read the
  719.     "REGISTRATION" section of this documentation.
  720.  
  721.  
  722.     Creating The Tryware Version
  723.     ────────────────────────────
  724.  
  725.     As you may have already noticed, you won't find either the "SHARECOM.COM"
  726.     program or the "USECOM.COM" program included in the distribution .ZIP
  727.     file.  This is because both the Tryware and the Registered versions of
  728.  
  729.     THE COMSHARE SYSTEM                                   GETTING STARTED   11
  730.  
  731.  
  732.  
  733.     both of these programs are created by the "INSTALL.EXE" program.
  734.  
  735.     But don't worry; the INSTALL.EXE program won't alter any of your
  736.     important files, like "AUTOEXEC.BAT" or "CONFIG.SYS" - it won't even
  737.     create any directories.
  738.  
  739.     The only thing that the INSTALL.EXE program will ever do is create the
  740.     two program files, "SHARECOM.COM" and "USECOM.COM" in the directory of
  741.     your choice, and then only if you ask it to.  It may also print to the
  742.     printer of your choice, but again, only if you ask it to.
  743.  
  744.     To obtain the Tryware version of the ComShare System then, you must
  745.     run the INSTALL.EXE program.
  746.  
  747.     The INSTALL.EXE program is so easy to use however, that you don't even
  748.     need to read the section of this documentation that details its use.
  749.     In fact, you could run it right now if you want to, by simply typing
  750.     in "INSTALL" at the DOS prompt (if you run into trouble, just hit the
  751.     ESCAPE key).
  752.  
  753.     If you are using a color card with either a Black & White or "Grey Scale"
  754.     monitor however, such as those found in monochrome laptops for instance,
  755.     you should start the Install program as "INSTALL /M" for increased
  756.     readability.
  757.  
  758.  
  759.     The PICKCOM.EXE Program
  760.     ───────────────────────
  761.  
  762.     As you may also have noticed by now, there is no file included with the
  763.     distribution .ZIP file with the name, "PICKCOM.EXE", nor is it created
  764.     by the INSTALL.EXE program.
  765.  
  766.     There are, however, two files included in the distribution .ZIP file
  767.     with the names, "PICKIPX.EXE" and "PICKNETB.EXE".  One of these is
  768.     the PICKCOM.EXE program you will be using for both the Tryware and the
  769.     Registered versions of the ComShare System.
  770.  
  771.     If you are using a Novell network, simply rename the "PICKIPX.EXE" to
  772.     "PICKCOM.EXE", and delete the "PICKNETB.EXE" file.
  773.  
  774.     If, on the other hand, you are using a NetBIOS-based network, such as
  775.     LANTASTIC, simply rename the "PICKNETB.EXE" file to "PICKCOM.EXE", and
  776.     delete the "PICKIPX.EXE" file.
  777.  
  778.     If that sounds a little confusing, the following little chart should
  779.     serve to make things a little clearer:
  780.  
  781.     ╔══════════════════════╤═══════════════════════════╤════════════════╗
  782.     ║  If you are using:   │  Rename to "PICKCOM.EXE"  │    & Delete    ║
  783.     ╠══════════════════════╪═══════════════════════════╪════════════════╣
  784.     ║  a Novell Network,   │  PICKIPX.EXE              │  PICKNETB.EXE  ║
  785.     ╟──────────────────────┼───────────────────────────┼────────────────╢
  786.     ║  a NetBIOS Network,  │  PICKNETB.EXE             │  PICKIPX.EXE   ║
  787.     ╚══════════════════════╧═══════════════════════════╧════════════════╝
  788.  
  789.     THE COMSHARE SYSTEM                                   GETTING STARTED   12
  790.  
  791.  
  792.  
  793.     Setting Up Your System
  794.     ──────────────────────
  795.  
  796.     Once you have procured the SHARECOM, USECOM, and PICKCOM programs
  797.     specific to the type of network you are running, it is strongly advisable
  798.     that you put all of them in a directory that exists in your PATH.
  799.  
  800.  
  801.     Theory & Nomenclature
  802.     ─────────────────────
  803.  
  804.     So far in this documentation, a "shareable" modem has been referred to
  805.     as just that:  a "shareable" modem.  In the ComShare System however, a
  806.     "shareable" modem or, to be more specific, any Com Port that has been
  807.     made shareable through the use of the ComShare System, is most often
  808.     referred to by its proper name, which is a "GRAD".
  809.  
  810.     A "GRAD" then, is any Com Port of any machine connected to the network
  811.     that has been made shareable by the ComShare System.
  812.  
  813.     The term "GRAD" can actually be thought of in two ways.  It is actually
  814.     an acronym for "Globally Responsive Asynchronous Device", but it could
  815.     just as easily be thought of as any modem (or Com Port) that has
  816.     "GRADuated" to the status of network resource.
  817.  
  818.     This is actually a key term, not only because the entire rest of the
  819.     documentation will be using it, but also because all help screens and
  820.     other peripheral documentation assume that you know what it is.
  821.  
  822.     Another key term used throughout this and other peripheral documentation
  823.     is "Com Port", which may or may not be abbreviated to the single term,
  824.     "Port" (such as in: "a 10-Port version").  A "Com Port" in the ComShare
  825.     System refers to both the physical Com Port of a single machine, and, by
  826.     extension, anything that might be attached to it, such as a modem.  In
  827.     fact, for the remainder of this documentation, the term "modem" will
  828.     generally not be used.
  829.  
  830.     The last of the key terms which may be used throughout this and other
  831.     documentation is the term, "In Session", which is the state the GRAD is
  832.     in when it is currently connected, across the network, to another (or the
  833.     same) machine.
  834.  
  835.     With those terms defined, it now becomes possible to provide a more
  836.     exacting explanation of the ComShare System's operation.
  837.  
  838.     First however, a little background is in order.  As any good DOS manual
  839.     will tell you, each of the Com Ports on a single machine are assigned a
  840.     unique number, or ordinal, from 1 to 4, which serves to distinguish it
  841.     from the other Com Ports on the same machine.
  842.  
  843.     In the same way, and for exactly the same reason, each GRAD created by
  844.     the SHARECOM program is assigned a unique number when it is created, and
  845.     the GRAD thus created can then be referred to specifically by that number,
  846.     which is known throughout the system as its "GRAD number".
  847.  
  848.     THE COMSHARE SYSTEM                                   GETTING STARTED   13
  849.  
  850.  
  851.  
  852.     GRAD numbers can be assigned arbitrarily or in sequence, depending on
  853.     your needs, and have nothing to do with the Com Port number of the Com
  854.     Port that the GRAD was created from (which is actually quite obvious if
  855.     you think about it).
  856.  
  857.     When using the USECOM program to connect to a GRAD then, you can ask to
  858.     be connected to either a single GRAD number, or the first available GRAD
  859.     in a series of GRAD numbers.  You could also instruct it to go ahead and
  860.     just grab the first one it finds.
  861.  
  862.     Given these premises, the ComShare System's operation can thus be
  863.     explained quite succinctly.  The SHARECOM program's main function can be
  864.     seen as one of transformation: it either transforms a Com Port into a
  865.     GRAD, or a GRAD back into a Com Port.  The USECOM program on the other
  866.     hand, either connects a (remote) GRAD to a local Com Port, which your
  867.     communications package can then access, or it disconnects a previously
  868.     made connection.
  869.  
  870.     For the SHARECOM program, this process of transforming a local Com Port
  871.     into a (usable) GRAD is called "Opening a Com Port", and reversing that
  872.     process once it has been accomplished, is called "Closing a Com Port".
  873.  
  874.     Conversely, for the USECOM program, "Opening a Com Port" refers to the
  875.     process of connecting a local Com Port to a remote GRAD and, as you
  876.     might have guessed, the reverse process is known as "Closing a Com Port".
  877.  
  878.     Another way of looking at the same process, which might be simpler for
  879.     some, is by using a telephone analogy.
  880.  
  881.     In the telephone analogy, each machine on the network is a house, and
  882.     each Com Port of each machine is an unconnected telephone.  The action of
  883.     "Opening a Com Port" by the SHARECOM program can then be understood as
  884.     "installing" a single telephone in the house, and when the USECOM program
  885.     is used to "Open a Com Port", it is "calling" that telephone.
  886.  
  887.     The telephone number in this case is the GRAD number of the GRAD (the
  888.     "installed" telephone) being "called".  A "connection" is then established
  889.     (the resident part of the SHARECOM program "answers the phone"), and
  890.     continues until the USECOM program is invoked again to "Close the Com
  891.     Port", which "hangs up" the "telephone".
  892.  
  893.     However you want to look at it, the main function of the SHARECOM program
  894.     is to create GRADs - the main function of the USECOM program is to use
  895.     them.  (maybe I should have said that in the first place ?)
  896.  
  897.  
  898.     Online Help
  899.     ───────────
  900.  
  901.     To assist in the operation of both the SHARECOM and USECOM programs, a
  902.     help screen is provided for each which summarizes both the general usage,
  903.     and each specific command line option available.  It is displayed whenever
  904.     either program is run with no command line parameters.  In other words,
  905.     typing in either "SHARECOM" or "USECOM" at the DOS command prompt will
  906.     display the help screen for the program being invoked.
  907.  
  908.     THE COMSHARE SYSTEM                                   GETTING STARTED   14
  909.  
  910.  
  911.  
  912.     The PICKCOM program's help screen on the other hand, can be displayed
  913.     by typing in, "PICKCOM help screen" at the DOS command prompt.
  914.  
  915.     The help screens are only meant as a quick reference however, and are
  916.     therefore quite terse.  For more specific information, the appropriate
  917.     section or sections of this documentation should be consulted.
  918.  
  919.     THE COMSHARE SYSTEM                                THE TERMS OF USAGE   15
  920.  
  921.  
  922.  
  923.     THE TERMS OF USAGE
  924.     ══════════════════════════════════════════════════════════════════════════
  925.  
  926.  
  927.     Copyright
  928.     ─────────
  929.  
  930.     The entire ComShare System, consisting of the ComShare System distribution
  931.     .ZIP file, all files contained in it, and all executable files created
  932.     through its use, is the sole property of David A. Stephenson and
  933.     NashaKala Corporation, and is protected by Canadian copyright laws,
  934.     international treaty provisions, and all other applicable national and
  935.     international laws.
  936.  
  937.     NashaKala Corporation however, grants you the right to use and distribute
  938.     the ComShare System distribution .ZIP file subject to the terms and
  939.     conditions of the Tryware License (defined below).
  940.  
  941.  
  942.     The Tryware License         ( License # T00000 )
  943.     ───────────────────
  944.  
  945.     You are hereby granted the right to use the Tryware version of the
  946.     ComShare System for any purpose for as long as you want, as long as:
  947.  
  948.     1)  You do not sell, lease, or otherwise seek or obtain remuneration or
  949.         compensation for its use, and
  950.  
  951.     2)  You do not attempt, either directly or indirectly, to disassemble or
  952.         otherwise reverse engineer any of its executables, and
  953.  
  954.     3)  You do not use it to make more than two Com Ports concurrently
  955.         shareable on the same network.
  956.  
  957.     You are also granted, and are encouraged to exercise, the right to freely
  958.     distribute the complete, unabridged, Author-Verified ComShare System
  959.     distribution .ZIP file, as long as:
  960.  
  961.     1)  It is not modified in any way, and
  962.  
  963.     2)  No monetary compensation is charged for its distribution beyond the
  964.         cost of such media as may be used to facilitate delivery, plus 10%.
  965.  
  966.  
  967.     Disclaimer
  968.     ──────────
  969.  
  970.     The entire ComShare System, consisting of the ComShare System distribution
  971.     .ZIP file, all files contained in it, and all executable files created
  972.     through its use, is provided AS IS without any warranty, expressed or
  973.     implied, including but not limited to warranties of merchantability or
  974.     fitness for any purpose.
  975.  
  976.     Both NashaKala Corporation and David A. Stephenson assume no liability
  977.     for any damages or losses, either direct or consequential, which may
  978.     result from the use or misuse of any part or parts of the ComShare System.
  979.  
  980.     THE COMSHARE SYSTEM                                THE TERMS OF USAGE   16
  981.  
  982.  
  983.  
  984.     Trademarks
  985.     ──────────
  986.  
  987.     "The ComShare System", "SHARECOM", "USECOM", & "PICKCOM" are trademarks
  988.     of NashaKala Corporation.
  989.  
  990.     Many specific products referred to in this manual are trademarks of
  991.     specific companies.
  992.  
  993.     THE COMSHARE SYSTEM                               THE INSTALL PROGRAM   17
  994.  
  995.  
  996.  
  997.     THE INSTALL PROGRAM
  998.     ══════════════════════════════════════════════════════════════════════════
  999.  
  1000.  
  1001.     As mentioned previously, it is the author's belief that one need not read
  1002.     this section of the documentation to be able to use the ComShare System's
  1003.     Install program, "INSTALL.EXE", with any degree of confidence.  Since
  1004.     every effort has been made to make the Install program conformant with the
  1005.     accepted norms for an interactive DOS program of its type, actually using
  1006.     the Install program is much easier than trying to grapple with the rather
  1007.     long-winded elucidations required to explain the intricacies of its use.
  1008.  
  1009.     If you are in any way unfamiliar with DOS-based menu systems however, or
  1010.     should you simply desire additional clarification on the Install program's
  1011.     specific menuing and data entry implementations, the two sub-sections
  1012.     entitled, "The INSTALL Program's Menus" and "The INSTALL Program's Data
  1013.     Entry Screens" are highly recommended reading, because they explain how
  1014.     the keyboard and mouse work with the Install program.
  1015.  
  1016.     Additionally, this section of the documentation exists as an invaluable
  1017.     reference for resolving any problems which might arise when either using
  1018.     the Install program, or filling out the ComShare System Order Form.  It
  1019.     may also be read in its entirety if desired, as every effort has been made
  1020.     to make it as coherent as possible.
  1021.  
  1022.  
  1023.     What The INSTALL Program Does
  1024.     ─────────────────────────────
  1025.  
  1026.     The Install program, INSTALL.EXE, included in the ComShare System's
  1027.     distribution .ZIP file, is used to:
  1028.  
  1029.     1)  Create the Tryware version of the ComShare System kernel
  1030.         ( files: SHARECOM.COM & USECOM.COM ), and/or
  1031.  
  1032.     2)  Create the Registered version(s) of the ComShare System kernel
  1033.         ( files: SHARECOM.COM & USECOM.COM ), and/or
  1034.  
  1035.     3)  Print out the ComShare System Order Form required to order the
  1036.         Registered License(s) of the ComShare System.
  1037.  
  1038.  
  1039.     Starting The INSTALL Program
  1040.     ────────────────────────────
  1041.  
  1042.     Starting, or more accurately, invoking the Install program couldn't be
  1043.     simpler.  Just type "INSTALL" at the DOS prompt.  You must ensure,
  1044.     however, that INSTALL.EXE exists in either the current directory, or a
  1045.     directory that exists in your DOS "PATH" environment variable.
  1046.  
  1047.     If you are using a color card with either a Black & White or "Grey Scale"
  1048.     monitor however, such as those found in monochrome laptops for instance,
  1049.     you should invoke the Install program as "INSTALL /M".  Otherwise, some of
  1050.     the color screens will be unreadable, especially in the Order Form section
  1051.     of the program.
  1052.  
  1053.     THE COMSHARE SYSTEM                               THE INSTALL PROGRAM   18
  1054.  
  1055.  
  1056.  
  1057.     How The INSTALL Program Works
  1058.     ─────────────────────────────
  1059.  
  1060.     The Install program is menu-driven.  What this means is that, as soon as
  1061.     it is invoked and throughout most of its operation, the Install program
  1062.     will be presenting you with a list, or "menu" of choices from which you
  1063.     are expected to choose, each of which, when chosen, either cause some
  1064.     action to be performed, or present you with another "menu" of further
  1065.     choices.
  1066.  
  1067.     In fact, the term "menu" is very apt here.  If a waiter in a restaurant
  1068.     presents you with a "menu" and asks you to choose, and you choose "bacon
  1069.     and eggs", the waiter will most likely present you with another "menu",
  1070.     only this time it will be a verbal one;  probably something like, "and
  1071.     will that be with white or brown toast?".  Each choice brings on further
  1072.     choices, until all questions have been answered, at which time a specific
  1073.     action is performed (you are served).
  1074.  
  1075.     In the same way, the Install program will present you with choices, until
  1076.     all questions have been answered, or resolved.  Then it will "serve" you.
  1077.  
  1078.     Sometimes however, instead of a list of choices, the Install program will
  1079.     present you with a "data entry window" containing one or more named fields
  1080.     which may or may not be blank, that need to be filled in with relevant
  1081.     information before the Install program can proceed.  If a named field in
  1082.     such a data entry window is not blank when it first appears, it is only
  1083.     because it has been filled in with a default value which can, of course,
  1084.     be changed.
  1085.  
  1086.  
  1087.     The INSTALL Program's Menus
  1088.     ───────────────────────────
  1089.  
  1090.     Each of the Install program's Menus, when active, are characterized by a
  1091.     list of items appearing in a single window on the console, which may be
  1092.     horizontally or vertically arranged.  Each item in the list is some word
  1093.     or phrase descriptive of the choice available, *one* of which will be
  1094.     "highlighted", which means that both the foreground and background color
  1095.     of its text will be different from all other items in the list.
  1096.  
  1097.     This "highlighted" item is "highlighted" by something called a "selection
  1098.     bar", which can be moved from one item to another.  As the "selection
  1099.     bar" is made to move, it "highlights" whatever item it happens to be on.
  1100.  
  1101.     In addition to "highlighting" an item, the selection bar serves to make
  1102.     that item the "current" item of the menu.  Two important properties of
  1103.     the "current" item are:
  1104.  
  1105.     1)  when applicable, a longer, more precise description of the "current"
  1106.         item is sometimes displayed in another window so that, by moving the
  1107.         selection bar from one item to another, further information can be
  1108.         gathered on each available choice, and
  1109.  
  1110.     2)  "choosing", or selecting, the current item is done by simply
  1111.         pressing the Enter Key.
  1112.  
  1113.     THE COMSHARE SYSTEM                               THE INSTALL PROGRAM   19
  1114.  
  1115.  
  1116.  
  1117.     When a particular menu is active, both choosing an item and moving
  1118.     through the menu is done through the use of either the keyboard or the
  1119.     mouse, as follows:
  1120.  
  1121.     LeftArrow   -  moves the selection bar one item to the left.
  1122.     RightArrow  -  moves the selection bar one item to the right.
  1123.     UpArrow     -  moves the selection bar one item upwards.
  1124.     DownArrow   -  moves the selection bar one item downwards.
  1125.  
  1126.     Enter  -  selects the item that the selection bar is on.
  1127.  
  1128.     Left Mouse Button  -  selects the item that the mouse is pointing to.
  1129.  
  1130.     Home  -  moves selection bar to the upper-leftmost item in the menu.
  1131.     End   -  moves selection bar to the lower-rightmost item in the menu.
  1132.  
  1133.     You may also, under certain circumstances, wish to abort a particular
  1134.     menu, which is also allowed.  When a menu is aborted, the window
  1135.     containing it is erased from the screen, and processing will usually
  1136.     continue with the menu or data entry screen which was active prior to
  1137.     activation of the menu.  In some circumstances however, it may make more
  1138.     sense to simply continue processing when a menu is aborted, in which case
  1139.     processing is continued as if the menu had never appeared.  The aborted
  1140.     menu is then said to have been 'skipped'.
  1141.  
  1142.     To abort a menu, you can either press the Escape key or the Right Mouse
  1143.     Button; either will suffice.
  1144.  
  1145.     Lastly, if one or more items in a menu contain a character that has a
  1146.     different foreground color than the rest of the characters in the item,
  1147.     you can choose, or "select" that item by simply typing that character on
  1148.     the keyboard.  If a menu item is "NetBIOS", for example, and the 'B'
  1149.     character appears in a different color than the rest of the characters
  1150.     in the word, you can select that item by simply typing in the letter 'B'.
  1151.  
  1152.  
  1153.     The INSTALL Program's Data Entry Screens
  1154.     ────────────────────────────────────────
  1155.  
  1156.     In order to gather the information it needs to satisfy a specific
  1157.     request, the Install program will occasionally need to display a "data
  1158.     entry window".  A "data entry window", otherwise known as a "data entry
  1159.     screen" is a window which contains both text and one or more "fields".
  1160.  
  1161.     A single "field" consists of one or more horizontally contiguous
  1162.     characters appearing in the window, any or all of which may be spaces,
  1163.     which have a different foreground color than all other characters in
  1164.     the window, and will always be either adjacent to and to the right of,
  1165.     or directly below, some brief descriptive text which serves to define
  1166.     its function, such as "Name", or "Address".
  1167.  
  1168.     A "data entry window" then, is characterized by one or more of these
  1169.     "fields" appearing in the window, ONE of which will be "highlighted",
  1170.     which means that both the foreground and background color of its text
  1171.     will be different than all other fields.  This "highlighted" field will
  1172.     also have a cursor blinking on and off somewhere inside it, usually at
  1173.  
  1174.     THE COMSHARE SYSTEM                               THE INSTALL PROGRAM   20
  1175.  
  1176.  
  1177.  
  1178.     the first character position.
  1179.  
  1180.     Therefore, once you see a blinking cursor inside a highlighted field, you
  1181.     will know that you are in a data entry window.  The highlighted field with
  1182.     the blinking cursor in it is called the "current field", and the position
  1183.     of the blinking cursor is known as the current "cursor position".  If the
  1184.     cursor position is moved to a different field, that field then becomes the
  1185.     current field, and therefore appears highlighted.
  1186.  
  1187.     When a data entry window is being displayed on the console, any printable
  1188.     characters that you type on the keyboard will be recorded at the current
  1189.     cursor position in the current field, and the cursor position will then
  1190.     be moved forward one character position, unless the particular character
  1191.     you typed doesn't make any sense in relation to the meaning of the current
  1192.     field, in which case the character typed will simply be ignored.  In this
  1193.     way a field can be "filled in" with whatever you type.
  1194.  
  1195.     Certain keys and key combinations have special meaning when a data entry
  1196.     window is being displayed however.  They are designed to help you move
  1197.     around, from field to field or position to position, within the data entry
  1198.     window.
  1199.  
  1200.     Before explaining the function of each of these special keys however,
  1201.     it's important to understand the following terms:
  1202.  
  1203.     The "first field" -  is the top, leftmost field in the data entry window.
  1204.  
  1205.     The "last field"  -  is the bottom, rightmost field in the data entry
  1206.                          window.
  1207.  
  1208.     The "next field"  -  is either the field to the right, if it exists, or
  1209.                          the field below, the current field.
  1210.  
  1211.     The "previous field"  -  is either the field to the left, if it exists,
  1212.                              or the field above, the current field.
  1213.  
  1214.     A "word"  -  is any consecutive series of non-blank characters in a field.
  1215.  
  1216.     Without further ado then, the following special keys and key combinations
  1217.     will produce the following results when a data entry window is being
  1218.     displayed.
  1219.  
  1220.     Most of the descriptions for these keys are, yes, regrettably long, but
  1221.     considerable time can be saved by reading only the first sentence in each
  1222.     of these descriptions.  The rest, generally speaking, is for reference
  1223.     purposes only.  They are also listed, more or less, in order of most
  1224.     common usage, so if you get really bored after reading a number of them,
  1225.     you can probably skip to the next sub-section.  It should also be
  1226.     mentioned at this point that the operation of these keys are, in fact,
  1227.     highly intuitive;  it is only their explanations which are cumbersome.
  1228.  
  1229.     THE COMSHARE SYSTEM                               THE INSTALL PROGRAM   21
  1230.  
  1231.  
  1232.  
  1233.       Key             Action
  1234.       ~~~             ~~~~~~
  1235.  
  1236.     Enter             "Finishes" the current field.  If the current field is
  1237.                       the last field, this key has the same effect as the
  1238.                       "Ctrl-Enter" key described below.  If not, it has the
  1239.                       same effect as the "Tab" key described below.  It is
  1240.                       useful for filling in the fields of a data entry
  1241.                       window sequentially.
  1242.  
  1243.     Ctrl-Enter        "Finishes" the data entry window, which will end the
  1244.                       entire data entry process.  It is useful for ending the
  1245.                       data entry process anytime before the last field has
  1246.                       been "finished".
  1247.  
  1248.     Esc               Aborts the data entry process.  Processing then usually
  1249.                       continues with the menu or data entry screen which was
  1250.                       active prior to activation of the data entry window.
  1251.                       In some circumstances however, it may make more sense
  1252.                       to simply continue processing when a data entry window
  1253.                       is aborted, in which case processing is continued as if
  1254.                       the data entry window had never appeared.
  1255.  
  1256.     Tab               Moves the cursor position to the first character of
  1257.                       either the next field, if it exists, or the first field.
  1258.                       It is used to step forward through the fields.
  1259.  
  1260.     Shift-Tab         Moves the cursor position to the first character of
  1261.                       either the previous field, if it exists, or the last
  1262.                       field.  It is used to step backwards through the fields.
  1263.  
  1264.     RightArrow        Moves the cursor position one character to the right.
  1265.                       If the cursor position is at the rightmost character
  1266.                       in the current field, it will be moved to the first
  1267.                       character of either the next field, if it exists, or
  1268.                       the first field.
  1269.  
  1270.     LeftArrow         Moves the cursor position one character to the left.
  1271.                       If the cursor position is at the leftmost character
  1272.                       in the current field, it will be moved to the last
  1273.                       character of either the previous field, if it exists,
  1274.                       or the last field.
  1275.  
  1276.     UpArrow           Makes the field directly above the cursor position the
  1277.                       current field.  If no field exists above the current
  1278.                       field, no action is performed.  The cursor position
  1279.                       within the new current field is set such that its
  1280.                       physical distance from the previous cursor position
  1281.                       is as close as possible.
  1282.  
  1283.     DownArrow         Makes the field directly below the cursor position the
  1284.                       current field.  If no field exists below the current
  1285.                       field, no action is performed.  The cursor position
  1286.                       within the new current field is set such that its
  1287.                       physical distance from the previous cursor position
  1288.                       is as close as possible.
  1289.  
  1290.     THE COMSHARE SYSTEM                               THE INSTALL PROGRAM   22
  1291.  
  1292.  
  1293.  
  1294.     Home              Moves the cursor position to the first character in the
  1295.                       current field.
  1296.  
  1297.     End               Moves the cursor position to the last character in the
  1298.                       current field.
  1299.  
  1300.     Insert            Toggles Insert Mode.  When Insert Mode is on, all
  1301.                       characters in the current field existing to the right
  1302.                       of the cursor position will move one character to the
  1303.                       right when a printable character is typed.  Thus, the
  1304.                       character typed will be "inserted" in the text of the
  1305.                       field, and the rightmost character in the current field
  1306.                       will be lost.  If the current field is changed, Insert
  1307.                       Mode will be turned off.  When off (the default), all
  1308.                       printable characters typed will replace the character
  1309.                       at the cursor position.  When Insert Mode is on, the
  1310.                       cursor will appear as a box rather than a line.  Insert
  1311.                       Mode also affects the action of the BackSpace key.
  1312.  
  1313.     BackSpace         Moves the cursor position one character to the left,
  1314.                       then deletes that character.  If Insert Mode is on, all
  1315.                       characters to the right of the deleted character are
  1316.                       then moved one character to the left, and a space is
  1317.                       manifested at the rightmost character position in the
  1318.                       field.  If Insert Mode is off, the deleted character
  1319.                       will simply be replaced by a space.  If the cursor
  1320.                       position is at the leftmost character in the field
  1321.                       when the BackSpace key is typed, the cursor position
  1322.                       is moved one character position past the last non-blank
  1323.                       character, if it exists, of the previous field, unless
  1324.                       the previous field does not exist, in which case no
  1325.                       action is performed.
  1326.  
  1327.     Delete            Deletes the character at the cursor position, then moves
  1328.                       all characters to the right of the deleted character one
  1329.                       character to the left.  A space is then manifested at
  1330.                       the rightmost character position in the field.
  1331.  
  1332.     Ctrl-RightArrow   Moves the cursor position to the beginning of the word
  1333.                       existing to the right of the current cursor position.
  1334.                       If the cursor position is at the rightmost character in
  1335.                       the current field, it will be moved to the beginning
  1336.                       of the first word in either the next field, if it
  1337.                       exists, or the first field.
  1338.  
  1339.     Ctrl-LeftArrow    Moves the cursor position to the beginning of the word
  1340.                       existing to the left of the current cursor position.
  1341.                       If the cursor position is at the leftmost character in
  1342.                       the current field, it will be moved to the beginning
  1343.                       of the last word in either the previous field, if it
  1344.                       exists, or the last field.
  1345.  
  1346.     Ctrl-Home         Moves the cursor position to the first character of
  1347.                       the first field.
  1348.  
  1349.     THE COMSHARE SYSTEM                               THE INSTALL PROGRAM   23
  1350.  
  1351.  
  1352.  
  1353.     Ctrl-End          Moves the cursor position to the last character of
  1354.                       the last field.
  1355.  
  1356.     Ctrl-BackSpace    Works exactly like the "BackSpace" key described above,
  1357.                       except that, instead of deleting just one character,
  1358.                       all consecutive non-blank characters to the left of the
  1359.                       cursor position, along with any spaces which might
  1360.                       precede or follow them, are deleted.
  1361.  
  1362.     Ctrl-R            Restores the current field to its original contents.
  1363.                       The "original contents" of a field are the contents it
  1364.                       had when the data entry window first became active.
  1365.  
  1366.     Ctrl-U            Deletes all characters from the cursor position to the
  1367.                       end of the current field.  The cursor position does not
  1368.                       move.
  1369.  
  1370.     Ctrl-Y            Deletes all characters from the cursor position to the
  1371.                       end of the current field, and all characters in all
  1372.                       fields below and to the right of the current field.
  1373.                       The cursor position does not move.
  1374.  
  1375.  
  1376.     The INSTALL Program's Main Menu
  1377.     ───────────────────────────────
  1378.  
  1379.     Once the Install program is invoked, it will display to the console its
  1380.     "Primary Window", which is a full-screen window containing, from the top:
  1381.  
  1382.     1)  an Identification Header, a boxed area at the very top of the Primary
  1383.         Window, which contains the program name and copyright information,
  1384.  
  1385.     2)  the "Main Menu", the one-line, top-level menu for the program,
  1386.  
  1387.     3)  the "menu description window", a one-line window for displaying a
  1388.         description of the "current" menu item, and
  1389.  
  1390.     4)  a rather generous, pattern-filled work area where most subsequent
  1391.         menus and data entry windows will appear.
  1392.  
  1393.  
  1394.     The Primary Window, with all of the aforementioned component parts, will
  1395.     look something like this:
  1396.  
  1397.     THE COMSHARE SYSTEM                               THE INSTALL PROGRAM   24
  1398.  
  1399.  
  1400.  
  1401. ▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄
  1402. ▌    * * *  C O M S H A R E    S Y S T E M   I N S T A L L  ver 1.00  * * *    ▐
  1403. ▌  The ComShare Telecommunications Resource Management System Install Utility  ▐
  1404. ▌        Copyright (c) 1994, David A. Stephenson & NashaKala Corporation       ▐
  1405. ▌                       - All rights reserved worldwide -                      ▐
  1406. ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
  1407. │          Create Executables                      Register COMSHARE           │
  1408. ├──────────────────────────────────────────────────────────────────────────────┤
  1409. │                Create the ComShare System Program Executables                │
  1410. ├──────────────────────────────────────────────────────────────────────────────┤
  1411. │°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙│
  1412. │°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙│
  1413. │°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙│
  1414. │°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙│
  1415. │°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙│
  1416. │°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙│
  1417. │°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙│
  1418. │°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙│
  1419. │°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙│
  1420. │°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙│
  1421. │°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙│
  1422. │°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙│
  1423. │°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙│
  1424. │°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙│
  1425. └──────────── - Press [ESC], or the Right Mouse Button, to exit - ─────────────┘
  1426.  
  1427.  
  1428.     The selection bar of the Main Menu, which cannot be shown in the above,
  1429.     will be on the "Create Executables" menu item, and the menu description
  1430.     window will therefore be displaying a brief description of what that
  1431.     means, in this case telling you that it means to "Create the ComShare
  1432.     System Program Executables".
  1433.  
  1434.     If you would like to create either the Tryware or Registered versions of
  1435.     the ComShare System, you should choose the "Create Executables" menu item
  1436.     from the Main Menu.  Further information on that choice is provided in
  1437.     the following sub-section entitled, "Creating The ComShare System Kernel".
  1438.  
  1439.     If you would like to print out the ComShare System Order Form to your
  1440.     printer so you can order a Registered License, you should choose the
  1441.     "Register ComShare" menu item from the Main Menu.  Further information
  1442.     on that choice is provided in the following sub-section entitled, "The
  1443.     ComShare System Order Form".
  1444.  
  1445.  
  1446.     Creating The ComShare System Kernel
  1447.     ───────────────────────────────────
  1448.  
  1449.     By selecting the "Create Executables" menu item from the Install program's
  1450.     Main Menu, you will be initiating the process of selecting the parameters
  1451.     for, and then producing, the ComShare System "kernel" which, for all
  1452.     versions of the ComShare System, is defined as the two executable files,
  1453.     "SHARECOM.COM" and "USECOM.COM".
  1454.  
  1455.     THE COMSHARE SYSTEM                               THE INSTALL PROGRAM   25
  1456.  
  1457.  
  1458.  
  1459.     This does not imply however, that these two files will be the same for
  1460.     all versions of the ComShare System;  in fact, quite the opposite is true.
  1461.     Both the size and contents of these two files will differ markedly between
  1462.     versions.
  1463.  
  1464.     In order to avoid confusion therefore, it is highly recommended that any
  1465.     previously created copies of both the "SHARECOM.COM" and "USECOM.COM"
  1466.     programs be deleted before attempting to produce them again for a
  1467.     different version.  That way you can be sure that you will be invoking
  1468.     the proper version of either program once they have been created.
  1469.  
  1470.     Upon selection of the "Create Executables" menu item, a new menu will
  1471.     pop up in the work area requiring you to choose between the Tryware or
  1472.     Registered versions of the ComShare System kernel.
  1473.  
  1474.     Selecting the "Tryware Version" menu item will cause the following to
  1475.     take place in the order indicated:
  1476.  
  1477.     1)  A new menu will pop up in the work area requiring you to choose which
  1478.         type of network, either NetBIOS-based or IPX/SPX-based, you wish the
  1479.         created kernel executables to be specific to.
  1480.  
  1481.         If you are running a Novell network, you should choose the "IPX/SPX-
  1482.         based" menu item.  For any other network, you should choose the
  1483.         "NetBIOS-based" menu item.
  1484.  
  1485.     2)  A data entry window then pops up in the work area, asking you what
  1486.         directory you would like the kernel programs to reside in.  The one
  1487.         field in this window will either be filled in with the full name of
  1488.         the current directory, or will be blank if the current directory name
  1489.         is too big to fit in the field.
  1490.  
  1491.         If you would like the created kernel executables to be placed in the
  1492.         current directory, simply hit the ENTER key.  If not, you can either
  1493.         type in the name of the directory to use, or edit the current one.
  1494.         A blank field will be interpreted as the current directory.
  1495.  
  1496.         If the directory you specify doesn't exist, or is an improper DOS
  1497.         directory name, the Install program will beep, display an error
  1498.         message indicating the problem, and offer you the choice of either
  1499.         returning to the data entry process to correct the problem, or
  1500.         abandoning the entire attempt, which will return you to the Main Menu.
  1501.  
  1502.     3)  Upon acceptance of the directory name, a confirmation will be printed
  1503.         in the window, and a new menu window will pop up asking you if you
  1504.         wish to "Proceed with this Install", for which the choices will be
  1505.         either "Yes" or "No".
  1506.  
  1507.         If all of the information appearing in the work area is correct, you
  1508.         should choose "Yes" from this menu.
  1509.  
  1510.         If either the Network specification or the directory name you input is
  1511.         incorrect however, you should choose "No".  This will take you back to
  1512.         step 2 (above), from which you can either correct the directory name,
  1513.         or hit the ESCAPE key once, which will take you back to step 1.
  1514.  
  1515.     THE COMSHARE SYSTEM                               THE INSTALL PROGRAM   26
  1516.  
  1517.  
  1518.  
  1519.     Alternatively, selecting the "Registered Version" menu item instead of the
  1520.     "Tryware Version" menu item, will cause the following to take place in the
  1521.     order indicated:
  1522.  
  1523.     1)  A new menu will pop up in the work area, each item of which will be
  1524.         the name of one of the six different Registered Licenses available.
  1525.  
  1526.         You should choose the item which corresponds to the Registered
  1527.         License you purchased.
  1528.  
  1529.     2)  A new menu will then pop up in the work area requiring you to choose
  1530.         which type of network, either NetBIOS-based or IPX/SPX-based, you wish
  1531.         the created kernel executables to be specific to.
  1532.  
  1533.         Again, you should choose the item which corresponds to the Registered
  1534.         License you purchased.
  1535.  
  1536.     3)  A data entry window then pops up in the work area which contains
  1537.         a brief textual description, followed by three data entry fields
  1538.         labeled "Licensee", "License number", and "Registration Key",
  1539.         respectively.
  1540.  
  1541.         The contents of these three fields are provided by the Registration
  1542.         Confirmation Letter sent to all Registered Users of the ComShare
  1543.         System, and should be transcribed into these fields accordingly.
  1544.  
  1545.         Once the three fields have been entered, the Install program will
  1546.         then check the consistency of all the information it has received so
  1547.         far.  If some or all of the information specified in the above steps
  1548.         1 through 3 is found to be inconsistent with the information found
  1549.         in the Registration Confirmation Letter you received as receipt of
  1550.         your purchase, the Install program will beep and display an error
  1551.         message indicating the problem, at which point typing any key will
  1552.         return you to the data entry window, where you can either attempt to
  1553.         correct the problem, or use the ESCAPE key to step back through the
  1554.         previous menus.
  1555.  
  1556.         If the Install program does display such an error message, it means
  1557.         that you have entered either the License, Network, Licensee, License
  1558.         number, or the Registration Key incorrectly.
  1559.  
  1560.     4)  Once the three fields have been accepted, the entire window is then
  1561.         scrolled up to create a second data entry area in which you are
  1562.         asked what directory you would like the kernel programs to reside
  1563.         in.  The one field in this area will either be filled in with the
  1564.         full name of the current directory, or will be blank if the current
  1565.         directory name is too big to fit in the field.
  1566.  
  1567.         If you would like the created kernel executables to be placed in the
  1568.         current directory, simply hit the ENTER key.  If not, you can either
  1569.         type in the name of the directory to use, or edit the current one.
  1570.         A blank field will be interpreted as the current directory.
  1571.  
  1572.         If the directory you specify doesn't exist, or is an improper DOS
  1573.         directory name, the Install program will beep, display an error
  1574.         message indicating the problem, and offer you the choice of either
  1575.  
  1576.     THE COMSHARE SYSTEM                               THE INSTALL PROGRAM   27
  1577.  
  1578.  
  1579.  
  1580.         returning to the data entry process to correct the problem, or
  1581.         abandoning the entire attempt, which will return you to the Main Menu.
  1582.  
  1583.     5)  Upon acceptance of the directory name, a confirmation will be printed
  1584.         in the window, and a new menu window will pop up asking you if you
  1585.         wish to "Proceed with this Install", for which the choices will be
  1586.         either "Yes" or "No".
  1587.  
  1588.         If all of the information appearing in the work area is correct, you
  1589.         should choose "Yes" from this menu.
  1590.  
  1591.         If any of the information specified in steps 1 through 5 above are
  1592.         incorrect however, you should choose "No".  This will take you back
  1593.         to step 3 (above), from which you can either correct the appropriate
  1594.         fields, or use the ESCAPE key to step back through the previous menus.
  1595.  
  1596.     Once all of the above steps have been completed for either the Tryware or
  1597.     Registered versions, the Install program will then attempt to create the
  1598.     SHARECOM.COM and USECOM.COM files in the directory you specified.
  1599.  
  1600.     If the Install program encounters an error while attempting to create the
  1601.     two files, it will beep, display an error message indicating the problem,
  1602.     and offer you the choice to either "Retry", which means to try writing
  1603.     out the files again, "ReEnter", which will abort the current attempt and
  1604.     return you to the data entry screen, or "Abandon", which will abort the
  1605.     entire attempt and return you to the Main Menu.
  1606.  
  1607.     Once the two files are successfully written out to the directory of your
  1608.     choice, a rather large confirmation window will appear explaining what
  1609.     was done, and offering you the choice to either "Exit to DOS", which will
  1610.     exit the Install program, or "Return to Main Menu", which will return you
  1611.     to the Main Menu.
  1612.  
  1613.  
  1614.     The ComShare System Order Form
  1615.     ──────────────────────────────
  1616.  
  1617.     By selecting the "Register ComShare" menu item from the Install program's
  1618.     Main Menu, you will be initiating the process of printing to the printer
  1619.     of your choice the ComShare System Order Form, which can either be filled
  1620.     out with the required information online, before printing, or filled out
  1621.     by hand (ie: with a pen) after printing.
  1622.  
  1623.     On the assumption that you will want to do this so that you can order a
  1624.     Registered License of the ComShare System, you are strongly advised to
  1625.     read the "REGISTRATION" section of this documentation before proceeding,
  1626.     if you haven't done so already, as this will provide you with important
  1627.     information that you need to know before making a purchase decision.
  1628.  
  1629.     Upon selection of the "Register ComShare" menu item, a new window will
  1630.     pop up containing the first of two "pages" of text, which will attempt to
  1631.     encapsulate the process of ordering a ComShare System Registered License.
  1632.     The second page of text is scrolled up through the window when any key
  1633.     (except ESCAPE) is typed.
  1634.  
  1635.     THE COMSHARE SYSTEM                               THE INSTALL PROGRAM   28
  1636.  
  1637.  
  1638.  
  1639.     At the bottom of the second page of text will be a two-item menu from
  1640.     which you can choose either the "Fill out Order Form" menu item, or the
  1641.     "Print Blank Order Form" menu item.
  1642.  
  1643.     If you wish to fill out the Order Form before printing it to your printer,
  1644.     thereby saving you the time and trouble of filling it out by hand, you can
  1645.     choose the "Fill out Order Form" menu item, the operational details for
  1646.     which are described in the following sub-section entitled, "Filling Out
  1647.     The Order Form".
  1648.  
  1649.     If, on the other hand, you would rather just print out a blank copy of the
  1650.     ComShare System Order Form and fill it in by hand, you should choose the
  1651.     "Print Blank Order Form" menu item, the operational details for which are
  1652.     described in the following sub-section entitled, "Printing Out The Order
  1653.     Form".
  1654.  
  1655.  
  1656.     Filling Out The Order Form
  1657.     ──────────────────────────
  1658.  
  1659.     If you choose the "Fill out Order Form" menu item from the two-item menu
  1660.     described above, two things happen, the first of which is that a data
  1661.     entry screen will be scrolled up into the window.  Before you can enter
  1662.     anything into it however, a small menu window will pop up on top of it,
  1663.     the text of which will be the question, "Is this your first time ordering
  1664.     the ComShare System ?", to which you can respond by choosing either a
  1665.     "Yes" menu item, or a "No" menu item.  Pressing the ESCAPE key will be
  1666.     considered a "Yes" response.
  1667.  
  1668.     If you do not already own a License to use a Registered version of the
  1669.     ComShare System, you should choose the "Yes" menu item (ie: "Yes", this
  1670.     is my first time ordering).  Upon doing so, the pop-up menu window will
  1671.     disappear and the data entry screen below it will become active, the
  1672.     operation of which is described in detail in the following sub-section
  1673.     entitled "Filling In The Licensee Information".
  1674.  
  1675.  
  1676.     Claiming the Previous Purchase Deduction
  1677.     ────────────────────────────────────────
  1678.  
  1679.     If you *do* own a License to use a Registered version of the ComShare
  1680.     System however, and want to upgrade your License to a higher-numbered
  1681.     Port License, you should choose the "No" menu item in response to the
  1682.     aforementioned question.
  1683.  
  1684.     If the "No" menu item is chosen, the pop-up menu window is expanded in
  1685.     size to accommodate a brief explanation of NashaKala Corporation's upgrade
  1686.     policy, at the bottom of which will appear the question, "Would you like
  1687.     to claim this deduction ?"  The "deduction" being referred to here is the
  1688.     deduction allowed for monies previously paid for Licenses of the ComShare
  1689.     System, which is called the "Previous Purchase Deduction".
  1690.  
  1691.     At this point, you can choose the "Yes" menu item to proceed, "No" to
  1692.     abandon the attempt to claim the deduction, or "Abandon", which will
  1693.     abandon the entire attempt to fill out the Order Form.  Hitting the
  1694.     ESCAPE key at this point is the same as choosing "No".
  1695.  
  1696.     THE COMSHARE SYSTEM                               THE INSTALL PROGRAM   29
  1697.  
  1698.  
  1699.  
  1700.     If you answer "Yes" to the above question, you are then prompted for the
  1701.     last License number assigned to you by NashaKala Corporation.  If the
  1702.     License number entered here is invalid or absent, an error window appears
  1703.     indicating the problem, and offers you the choice to either "Continue",
  1704.     which will allow you to re-enter your License number, or "Abandon", which
  1705.     will abandon the attempt to claim the deduction.  Pressing the ESCAPE key
  1706.     when entering the License number will also abandon the attempt to claim
  1707.     the deduction.
  1708.  
  1709.     Once your License number has been input, further explanatory text is
  1710.     scrolled up into the window which reaffirms the fact that all previously
  1711.     purchased Licenses on which the deduction is based will be revoked upon
  1712.     NashaKala Corp.'s acceptance of the deduction.  A reaffirmation of your
  1713.     intention to claim the deduction in light of this is then requested in
  1714.     the form of a "Yes" or "No" response.
  1715.  
  1716.     At this point, either choosing the "No" menu item or pressing the ESCAPE
  1717.     key will abort the attempt to claim the deduction, close the pop-up
  1718.     window, and activate the data entry window underneath it.
  1719.  
  1720.     If you reaffirm your intention to claim the deduction by choosing the
  1721.     "Yes" menu item however, you are then prompted for the dollar amount you
  1722.     wish to deduct from the current order.  The dollar amount you enter here
  1723.     should be the exact dollar amount you have previously paid to NashaKala
  1724.     Corporation for only those lesser-numbered Port Licenses of the Registered
  1725.     version that you either no longer use or will no longer be using once you
  1726.     receive the new License or Licenses.
  1727.  
  1728.     Normally, this dollar amount will be the same as the purchase price of
  1729.     your last previously purchased License.  In the case of having previously
  1730.     purchased more than one currently active License however, which in itself
  1731.     is rare, there does exist the remote possibility that the correlation
  1732.     between the dollar amount deducted and which of the previously purchased
  1733.     Licenses contributed to it will be unclear.  If such is the case, you
  1734.     can easily avoid delays in your order by specifying, in the "Additional
  1735.     Comments" section of the Order Form (once it is printed), exactly which
  1736.     of the previously purchased Licenses make up the deduction you wish to
  1737.     claim.
  1738.  
  1739.     Of course, all deduction amounts claimed are subject to verification by
  1740.     NashaKala Corporation before they can be accepted.
  1741.  
  1742.     Once the dollar amount of the deduction is successfully entered, a two
  1743.     line confirmation is then printed at the bottom of the window which
  1744.     reiterates both your current License number, and the dollar amount just
  1745.     entered.  A small "confirmation" window then pops up, the text of which
  1746.     is the question, "Is This Correct?" for which a menu is displayed
  1747.     allowing for either a "No", "Yes", or "Abandon" response.  Pressing the
  1748.     ESCAPE key will be considered a "No" response.  The confirmation window
  1749.     disappears once a response is received.
  1750.  
  1751.     Selecting the "No" menu item will allow you to edit either the displayed
  1752.     License number and/or the displayed deduction amount, after which the
  1753.     confirmation process will be repeated.  Selecting the "Abandon" menu item
  1754.     will abandon the entire attempt to claim the Previous Purchase Deduction,
  1755.     the active window will disappear, and the data entry screen underneath it
  1756.  
  1757.     THE COMSHARE SYSTEM                               THE INSTALL PROGRAM   30
  1758.  
  1759.  
  1760.  
  1761.     will be activated.  And finally, selecting the "Yes" menu item from the
  1762.     confirmation window's menu will cause the Install program to accept the
  1763.     Previous Purchase Deduction as displayed, close the active window, and
  1764.     proceed with the "Licensee Information" data entry process, which is
  1765.     described below.
  1766.  
  1767.  
  1768.     Filling In The Licensee Information
  1769.     ───────────────────────────────────
  1770.  
  1771.     Once the processing of the Previous Purchase Deduction has been either
  1772.     completed or aborted, the Licensee Information data entry screen becomes
  1773.     active.
  1774.  
  1775.     The Licensee Information data entry screen, as its name implies, contains
  1776.     10 fields which have to do with the information pertaining to the person
  1777.     and/or the company buying the License (the "Licensee").  Not all fields
  1778.     are required to process an order, and no error checking is done on any
  1779.     of the fields.  Pressing the ESCAPE key while the Licensee Information
  1780.     data entry screen is active will abort the entire attempt to fill out
  1781.     the Order Form.
  1782.  
  1783.     The following fields are present in the data entry window, and are listed
  1784.     in the order that they appear in that window, from top to bottom and left
  1785.     to right:
  1786.  
  1787.     Name - This field is required, and should be the full name of either the
  1788.            individual buying the License, or an authorized representative of
  1789.            the company buying the License.
  1790.  
  1791.     Title - This field is only required if a company is buying the License,
  1792.             and serves more as an indication of the level of authorization
  1793.             involved than anything else.  It is the job title of the person
  1794.             whose name appears in the Name field (above).
  1795.  
  1796.     Company - This field is only required if a company is buying the License.
  1797.               It is the full name of the company.
  1798.  
  1799.     Address - This field is required.  If you require the Registration
  1800.               Confirmation Letter to be sent to an address other than this,
  1801.               it should be specified in the "Additional Comments" section of
  1802.               the Order Form.
  1803.  
  1804.     City, State, and Zip Code - These fields are also required, and are fairly
  1805.                                 self-explanatory.  The case of all alphabetic
  1806.                                 input is pre-determined for these fields.
  1807.  
  1808.     Country - This field is only required if the City name is not unique.
  1809.               The case of all alphabetic input is pre-determined.
  1810.  
  1811.     Phone #, and Fax # - These two fields are both optional.  Only numeric
  1812.                          input is accepted.  The first three numbers input
  1813.                          for each should be the area code, which is actually
  1814.                          considered a separate field by the Install program.
  1815.  
  1816.     THE COMSHARE SYSTEM                               THE INSTALL PROGRAM   31
  1817.  
  1818.  
  1819.  
  1820.     Once all of the above fields have been input, a small "confirmation"
  1821.     window pops up, the text of which is the question, "Is This Correct?" for
  1822.     which a menu is displayed allowing for either a "No", "Yes", or "Abandon"
  1823.     response.  Pressing the ESCAPE key will be considered a "No" response.
  1824.     The confirmation window disappears once a response is received.
  1825.  
  1826.     Selecting the "No" menu item will reactivate the Licensee Information
  1827.     data entry window, allowing you to edit any of the previously input
  1828.     fields, after which the confirmation process will be repeated.  Selecting
  1829.     the "Abandon" menu item will abandon the entire attempt to fill out the
  1830.     Order Form, and selecting the "Yes" menu item will initiate processing
  1831.     of the "Order Information" data entry screen, the operation of which is
  1832.     described below.
  1833.  
  1834.  
  1835.     Filling In The Order Information
  1836.     ────────────────────────────────
  1837.  
  1838.     Once the Licensee Information has been successfully input (above), the
  1839.     Order Information data entry screen is scrolled up into the window.
  1840.  
  1841.     The Order Information data entry screen contains six numeric input fields.
  1842.     Each of these represent, in turn, the number of each of the six different
  1843.     types of Registered Licenses you wish to purchase, and are labeled
  1844.     accordingly.  The first, or topmost field, for instance, represents the
  1845.     number of 2-Port Registered Licenses you would like to order.  Pressing
  1846.     the ESCAPE key while the Order Information data entry screen is active
  1847.     will abort the entire attempt to fill out the Order Form.
  1848.  
  1849.     Normally, unless you are buying for more than one LAN, you would only
  1850.     need to order a single License, so only one of the fields would need to
  1851.     be entered, and would contain the number one.
  1852.  
  1853.     Just in case you are interested in buying more than one License however,
  1854.     each of the fields can accept any number from zero to 99 inclusive, and
  1855.     the total purchase price for each type of License is displayed to the
  1856.     right of the quantity entered.  A total purchase price for the entire
  1857.     order is also displayed at the bottom of the window.
  1858.  
  1859.     If you wish to order more than 99 Registered Licenses of a certain type,
  1860.     you will have to leave all fields blank and fill out the Order Information
  1861.     in the printed Order Form by hand, including all monetary totals.
  1862.  
  1863.     Once all the Order Information is entered, a confirmation window pops up,
  1864.     the function and operation of which is exactly the same as that described
  1865.     in the previous section for the Licensee Information data entry screen,
  1866.     and serves to finalize the Order Information data entry process.
  1867.  
  1868.  
  1869.     Choosing The Licensee Identification
  1870.     ────────────────────────────────────
  1871.  
  1872.     Once the Order Information has been successfully input as described above,
  1873.     the first of two "pages" of text will be scrolled up into the window which
  1874.     attempts to explain the general concept of the "Licensee Identification",
  1875.     the major component of which is the "Licensed to" designation.  The second
  1876.  
  1877.     THE COMSHARE SYSTEM                               THE INSTALL PROGRAM   32
  1878.  
  1879.  
  1880.  
  1881.     page of text is scrolled up through the window when any key (except
  1882.     ESCAPE) is typed.
  1883.  
  1884.     The "Licensed to" designation is a text field of up to 50 characters
  1885.     which is written, or "stamped" into every Licensed copy of the Registered
  1886.     version at the time it is created by the Install program, and serves to
  1887.     uniquely identify the owner of the License.
  1888.  
  1889.     But because the "Licensed to" designation is prominently displayed when-
  1890.     ever any program in the Registered version is executed, it is important
  1891.     that a "Licensed to" designation be chosen that will not create needless
  1892.     confusion among those who might use that Registered version on the single
  1893.     network for which it is Licensed.
  1894.  
  1895.     For example, if Ms. Amy Abull of the Purchasing Department at "XYZappa"
  1896.     Corporation" purchases a 20-Port Registered License of the ComShare
  1897.     System, which is slated for use by the Accounting Department, it would
  1898.     definitely cause confusion to those in the Accounting Department using
  1899.     the Registered version if they were to read:
  1900.  
  1901.     "Licensed to:  Ms. Amy Abull, 1313 HomeSpun Drive"
  1902.  
  1903.     every time they invoked one of the ComShare System executables, especially
  1904.     if she were to someday leave the company.
  1905.  
  1906.     To avoid such an unfortunate scenario, the ComShare System Order Form
  1907.     allows you to choose between a number of different ways the "Licensed to"
  1908.     designation can be expressed.
  1909.  
  1910.     At the bottom of the aforementioned second page of displayed text there-
  1911.     fore, a menu of the different ways the "Licensed to" designation can be
  1912.     expressed is presented, from which you can choose.  Each represents a
  1913.     different checkbox in the Order Form.  Unlike most menus in the Install
  1914.     program however, typing the ESCAPE key while this menu is active will not
  1915.     abort processing, but will instead be interpreted by the Install program
  1916.     as meaning that you would prefer to specify this information in the Order
  1917.     Form by hand, after it has been printed.  The menu will therefore simply
  1918.     be 'skipped' if the ESCAPE key is pressed.
  1919.  
  1920.     The menu items available to select, and a brief description of the
  1921.     resultant "Licensed to" designation consequently produced by each is
  1922.     as follows:
  1923.  
  1924.  
  1925.     The Company Name Only  -  This will be the most common, and probably the
  1926.     ~~~~~~~~~~~~~~~~~~~~~     wisest choice for purchases made by a company,
  1927.                               other than the "Other" choice (see below), and
  1928.                               consists, obviously enough, of the company name
  1929.                               only.  The city and state may be added at the
  1930.                               end if the company name is not sufficiently
  1931.                               unique.
  1932.  
  1933.     My Name Only  -  This is available for single individuals, as opposed to
  1934.     ~~~~~~~~~~~~     companies, who purchase a License and consists of the
  1935.                      full name of the purchaser.  Additional information from
  1936.                      the Order Form may have to be appended however, if the
  1937.  
  1938.     THE COMSHARE SYSTEM                               THE INSTALL PROGRAM   33
  1939.  
  1940.  
  1941.  
  1942.                      name is not sufficiently unique.  Specifying a middle
  1943.                      name or initial in the Order Form will tend to obviate
  1944.                      the need to append information.
  1945.  
  1946.     My Name And Company  -  For company orders, this combination of
  1947.     ~~~~~~~~~~~~~~~~~~~     information may be desirable, especially if both
  1948.                             are intrinsically linked to the purchase.  It
  1949.                             consists of the full name of the purchaser as
  1950.                             entered in the Order Form, followed by the word
  1951.                             'and', followed by the name of the company.  If
  1952.                             there is not enough space for both, the first or
  1953.                             middle names may be abbreviated.  If there is
  1954.                             still too little room, only the company name will
  1955.                             be used.
  1956.  
  1957.     My Name And Title  -  For both individual and company orders, this
  1958.     ~~~~~~~~~~~~~~~~~     combination of information may be desirable.  It
  1959.                           consists of the full name of the purchaser followed
  1960.                           by a comma, then whatever is entered in the Order
  1961.                           Form as the 'Title'.  If no company name is present
  1962.                           in the Order Form and this option is specified, then
  1963.                           it will be assumed that the 'Title' information was
  1964.                           specified for only this purpose, and will therefore
  1965.                           be ignored for all other purposes.
  1966.  
  1967.     I don't care  -  If this menu choice is selected and the purchaser is a
  1968.     ~~~~~~~~~~~~     company, then the company name will be used.  If not,
  1969.                      then the full name of the purchaser will be used.
  1970.                      Either may be appended with peripheral information if
  1971.                      necessary.  This option shows up on the ComShare System
  1972.                      Order Form as "I have No Preference".
  1973.  
  1974.     Other  -  This alternative is available for those purchasers who prefer
  1975.     ~~~~~     to have more direct control over the contents of the "Licensed
  1976.               to" designation.  If this choice is selected, which will appear
  1977.               on the printed Order Form as "see Additional Comments", the
  1978.               purchaser is required to provide in the "Additional Comments"
  1979.               section of the ComShare System Order Form either the exact
  1980.               wording for, or the specific combination of information to be
  1981.               used in, the "Licensed to" designation.
  1982.  
  1983.               Selecting this menu choice therefore enables you to "customize"
  1984.               the "Licensed to" designation to your specific situation.  If
  1985.               the Registered version is to be used by the accounting dept. of
  1986.               company "XYZappa" for example, the "Licensed to" designation
  1987.               could be specified as "Accounting Dept., XYZappa Corp." in the
  1988.               "Additional Comments" section of the Order Form.
  1989.  
  1990.               The "Licensed to" designation must be unique enough to obviate
  1991.               any possible ambiguity with regard to who the Licensee really
  1992.               is however.  If it is not, information supplied in the Order
  1993.               Form may have to be arbitrarily appended to make it distinctive.
  1994.               The conditions under which this may occur can also be specified
  1995.               in the "Additional Comments" section of the Order Form if
  1996.               desired, such as in comments like, "notify me before appending"
  1997.               or "do not fill my order if designation is unacceptable".
  1998.  
  1999.     THE COMSHARE SYSTEM                               THE INSTALL PROGRAM   34
  2000.  
  2001.  
  2002.  
  2003.               If this menu choice is selected, a further page of text is then
  2004.               scrolled up into the display window which attempts to explain
  2005.               the above concepts, at the bottom of which will be a two-item
  2006.               confirmation menu from which you can choose either "Yes" to
  2007.               confirm your choice, or "No", which will take you back to the
  2008.               previous menu.  Typing the ESCAPE key will be considered a "No"
  2009.               response.
  2010.  
  2011.  
  2012.     Specifying The Network Type
  2013.     ───────────────────────────
  2014.  
  2015.     Once the choice of a suitable "Licensed to" designation has either been
  2016.     made or deferred as described above, a small menu window will pop up
  2017.     requiring you to choose which type of network, either NetBIOS-based or
  2018.     IPX/SPX-based, you wish the Licensed copies of your Registered version
  2019.     to be specific to.
  2020.  
  2021.     If you are running a Novell network, you should choose the "IPX/SPX-based"
  2022.     menu item.  For any other network, you should choose the "NetBIOS-based"
  2023.     menu item.
  2024.  
  2025.     This menu can be 'skipped' by typing the ESCAPE key, which will be inter-
  2026.     preted by the Install program as meaning that you would prefer to specify
  2027.     this information in the Order Form by hand, after it has been printed.
  2028.     Processing will continue regardless.
  2029.  
  2030.  
  2031.     Printing Out The Order Form
  2032.     ───────────────────────────
  2033.  
  2034.     Once the ComShare Order Form is ready to be printed, either after it has
  2035.     been filled out online as described above, or upon the selection of the
  2036.     "Print Blank Order Form" menu item, a small menu window will pop up, each
  2037.     menu item of which will be the name of a printer "device".
  2038.  
  2039.     The printer you choose here will be the printer used to print out the
  2040.     ComShare System Order Form.  If you are unsure about which one to choose,
  2041.     a pretty safe bet would be to choose the "PRN" menu item at the top of
  2042.     the list because it is, by definition, the "default" printer for your
  2043.     system.  Typing the ESCAPE key will abort the printing process and return
  2044.     you to the top level menu of the "Register ComShare" process.
  2045.  
  2046.     Once a printer has been chosen, yet another menu window will pop up, the
  2047.     brief text of which will ask you to ensure that your printer is ready to
  2048.     print at the top of the page, below which will be a horizontal menu of
  2049.     three choices.
  2050.  
  2051.     At this point, you can choose either the "Start Printing" menu item, which
  2052.     will cause the Install program to print out the entire ComShare System
  2053.     Order Form to the printer you chose in the previous menu, the "New Page"
  2054.     menu item, which will cause a single page eject to be issued to the
  2055.     printer, presumably in preparation for the print process, or the "Abandon"
  2056.     menu item, which will abort the attempt to print out the Order Form.
  2057.  
  2058.     THE COMSHARE SYSTEM                               THE INSTALL PROGRAM   35
  2059.  
  2060.  
  2061.  
  2062.     If the Install program encounters an error while printing, it will beep,
  2063.     display an error message indicating the problem, and offer you the choice
  2064.     to either "Retry", which will attempt to continue printing, presumably
  2065.     after the problem has been corrected, "ReStart", which will abort printing
  2066.     and return to the printer selection menu, or "Abandon", which will abort
  2067.     printing and return to the top level menu of the "Register ComShare"
  2068.     process.  Typing the ESCAPE key will be considered a "ReStart" response.
  2069.  
  2070.     Once the ComShare System Order Form has successfully been printed, a
  2071.     rather large confirmation window will appear briefly outlining the
  2072.     remaining steps involved in the Registration process, and offering you
  2073.     the choice to either "Exit to DOS", which will exit the Install program,
  2074.     or "Return to Main Menu", which will return you to the Main Menu.
  2075.  
  2076.     THE COMSHARE SYSTEM                       MAKING A COM PORT SHAREABLE   36
  2077.  
  2078.  
  2079.  
  2080.     MAKING A COM PORT SHAREABLE
  2081.     ══════════════════════════════════════════════════════════════════════════
  2082.  
  2083.  
  2084.     This section of the documentation assumes that you have read at least the
  2085.     "Theory & Nomenclature" sub-section of the "GETTING STARTED" section of
  2086.     this documentation, as most of the key terms used here are defined there.
  2087.  
  2088.  
  2089.     The SHARECOM Program
  2090.     ────────────────────
  2091.  
  2092.     The SHARECOM program can be used to:
  2093.  
  2094.     1) create a GRAD on the network from a Com Port of a single machine,
  2095.     2) transform a previously created GRAD back to an ordinary Com Port, or
  2096.     3) provide machine-specific status information.
  2097.  
  2098.     The first two of the above functions requires a separate invocation of
  2099.     the SHARECOM program; the third can be performed either separately or in
  2100.     conjunction with the other two.  For example, to create two separate
  2101.     GRADs on a single machine would require, at a minimum, two separate
  2102.     invocations of the SHARECOM program (one for each GRAD), each of which
  2103.     may or may not be accompanied by status information.
  2104.  
  2105.     The first of the three above listed functions of the SHARECOM program,
  2106.     that of creating a GRAD, is called "Opening a Com Port".  The second of
  2107.     the three is called "Closing a Com Port", and the third is known as
  2108.     "Ascertaining the Status".  The definitions of these terms are specific
  2109.     to the SHARECOM program however, as they have different meanings when
  2110.     used in the context of the USECOM program.
  2111.  
  2112.     Communication with the SHARECOM program is done exclusively through its
  2113.     command line, and consists of zero or more "options", followed by an
  2114.     optional Com Port number.
  2115.  
  2116.     The optional Com Port number, if specified, must be a single digit
  2117.     decimal number between 1 and 4 inclusive, which represents the Com Port
  2118.     number of the Com Port you wish acted upon.  If not specified, the
  2119.     SHARECOM program will attempt to perform the requested function on the
  2120.     first Com Port it finds that is valid in the context of the requested
  2121.     function it is being asked to perform.
  2122.  
  2123.     Each "option" on the command line is a unique text string which serves
  2124.     to specify either what or how an action is to be performed.  Each option
  2125.     on the command line must be preceded by either a '/' or a '-' character
  2126.     for it to be recognized by the SHARECOM program as an option, otherwise
  2127.     it will be interpreted as a Com Port number.
  2128.  
  2129.     For convenience, each option on the command line may be abbreviated to
  2130.     the least number of characters necessary to resolve ambiguity with any
  2131.     other option.  The option, "/OPEN", for example, may be abbreviated to
  2132.     "/O", because no other option starts with an "O", but the minimum
  2133.     abbreviation for the "/SHUTDOWN" option, for example, must be "/SH",
  2134.     because anything less might be interpreted as the "/STATUS" option.
  2135.  
  2136.     THE COMSHARE SYSTEM                       MAKING A COM PORT SHAREABLE   37
  2137.  
  2138.  
  2139.  
  2140.     Some options require parameter values to be specified, which may be
  2141.     textual or numeric, depending on the option.  If an option does require
  2142.     a parameter value, then either an '=' or a ':' character must exist
  2143.     between it and the parameter value, with no spaces in between, such as
  2144.     in "/GRAD=2", or "/ADDR:2f8".
  2145.  
  2146.     All of SHARECOM's command line options are case insensitive.  Specifying
  2147.     "/OpEn" is equivalent to specifying, "/oPeN", for example.  Option
  2148.     parameter values however, may or may not be case sensitive, depending on
  2149.     the requirements of the option itself.
  2150.  
  2151.     Spaces or tabs may exist between options, but are only necessary following
  2152.     those options which take parameters.
  2153.  
  2154.  
  2155.     Memory Considerations
  2156.     ─────────────────────
  2157.  
  2158.     In order to Open a Com Port, the SHARECOM program must leave a piece of
  2159.     itself in memory after it has been invoked.  This "piece of memory"
  2160.     consists of the part of the SHARECOM program that will operate in the
  2161.     background managing the GRAD, which is about 7K in size, and a resident
  2162.     character buffer of approximately 2K for the NetBIOS version, 3K for the
  2163.     IPX/SPX version, for holding any incoming and outgoing characters on
  2164.     behalf of the GRAD.
  2165.  
  2166.     Once the first GRAD on a single machine has been created however, any
  2167.     GRADs subsequently created by the SHARECOM program on the same machine
  2168.     will only require another 2-3K of resident memory - for the new GRAD's
  2169.     character buffer.
  2170.  
  2171.     Closing a Com Port, on the other hand, involves, amongst other things,
  2172.     releasing the resident memory required for the GRAD's character buffer.
  2173.  
  2174.     Because a PC's resident memory is assigned sequentially however, much
  2175.     like bricks being stacked on top of one another, problems may arise if
  2176.     SHARECOM is asked to Close a Com Port that was Opened prior to another
  2177.     Com Port being Opened.  In this case, if SHARECOM releases the Opened
  2178.     GRAD's buffer, it will create a "hole" in memory where the buffer used
  2179.     to be, which causes great problems for DOS.
  2180.  
  2181.     Knowing this, the SHARECOM program will issue an error message and abort
  2182.     if it is asked to Close a Com Port whose buffer is trapped underneath
  2183.     other blocks of used resident memory, whether or not those other blocks
  2184.     were created by the SHARECOM program.
  2185.  
  2186.     To avoid this situation, all resident memory appropriated *after* a Com
  2187.     Port has been Opened, which may include memory taken up by other programs,
  2188.     must be released prior to attempting to Close that Com Port.
  2189.  
  2190.     This also implies that the Com Ports on a single machine can only be
  2191.     Closed in the *reverse* order that they were Opened in.  This is
  2192.     unfortunate but, alas, is more a limitation of residency under the DOS
  2193.     operating system than anything else.
  2194.  
  2195.     THE COMSHARE SYSTEM                       MAKING A COM PORT SHAREABLE   38
  2196.  
  2197.  
  2198.  
  2199.     Opening A Com Port
  2200.     ──────────────────
  2201.  
  2202.     When the SHARECOM program Opens a Com Port, a series of actions are
  2203.     initiated which all must be successful before a GRAD will be created.
  2204.     If an error occurs during any one of these actions, SHARECOM will abort
  2205.     the entire attempt with an appropriate error message, and exit.
  2206.  
  2207.     The series of actions, in the order in which they are performed, are:
  2208.  
  2209.     1)  IF the SHARECOM program's resident code is not already in memory,
  2210.         from either a previous "/OPEN", or a previous "/LOAD" command, then
  2211.         the SHARECOM program will attempt to "Register the Node" which, in
  2212.         essence, means creating a network address for the machine that it is
  2213.         running on for the purposes of communicating to other machines on
  2214.         the network.
  2215.  
  2216.     2)  The Com Port's hardware is then checked to see if everything is
  2217.         working correctly.
  2218.  
  2219.     3)  The entire network is then searched for an available (unused) GRAD
  2220.         number that it can assign to the GRAD being created.
  2221.  
  2222.     4)  Finally, the GRAD is created, and a memory resident character buffer
  2223.         is allocated for the new GRAD.
  2224.  
  2225.     Before performing any of the above actions, except for the last one, the
  2226.     SHARECOM program will display to the console a one-line status message
  2227.     indicative of the action it is about to perform.  Upon successful
  2228.     completion of all of the actions, a confirmation of the Open is then
  2229.     displayed.
  2230.  
  2231.     If the Com Port number is unspecified on the command line, SHARECOM will
  2232.     attempt to Open the first available unopened Com Port, starting with Com
  2233.     Port 1, until all four Com Ports have been tried.
  2234.  
  2235.     Once the SHARECOM program has successfully Opened a Com Port, it will then
  2236.     return control back to the DOS prompt, at which point the machine can be
  2237.     used as it normally would be, with the following exceptions:
  2238.  
  2239.     1)  The PAUSE key should never be used once a GRAD has been created,
  2240.         as it may interrupt the resident part of the SHARECOM program's
  2241.         processing, and
  2242.  
  2243.     2)  Resident "pop-up" utilities should not be invoked either, for the
  2244.         same reason.
  2245.  
  2246.     To Open a Com Port, the following command line options may be used:
  2247.  
  2248.  
  2249.     The "/OPEN" Command Line Option             minimum abbreviation:  "/O"
  2250.     ───────────────────────────────
  2251.  
  2252.     Specifying this option causes SHARECOM to attempt to Open a Com Port.
  2253.     It does not take a parameter value.
  2254.  
  2255.     THE COMSHARE SYSTEM                       MAKING A COM PORT SHAREABLE   39
  2256.  
  2257.  
  2258.  
  2259.     The "/ADDR" Command Line Option             minimum abbreviation:  "/A"
  2260.     ───────────────────────────────
  2261.  
  2262.     This option is used to tell SHARECOM the HEXidecimal address of the
  2263.     Com Port that is to be Opened.
  2264.  
  2265.     The use of this option implies the "/OPEN" option, which means that if
  2266.     this option is used, SHARECOM will assume that you are trying to Open a
  2267.     Com Port, whether the "/OPEN" option was specified or not.
  2268.  
  2269.     It requires a hexidecimal (base 16) parameter value, which represents
  2270.     the base address of the Com Port that is to be Opened.  It is case
  2271.     insensitive.
  2272.  
  2273.     Ordinarily, the use of this option when Opening either Com Port 1 or 2
  2274.     is unnecessary, because the machine itself (the ROM BIOS) knows where
  2275.     they are, and very good machines may even be able to detect the addresses
  2276.     of Com Ports 3 and 4 if they exist.
  2277.  
  2278.     In any event, if this option is not specified when Opening a Com Port,
  2279.     the SHARECOM program will report an error if the machine itself does not,
  2280.     or cannot, provide the address.
  2281.  
  2282.     If SHARECOM does report such an error, this option must be used to input
  2283.     the correct value, which can normally be obtained from the Serial Card
  2284.     documentation.  Some Common values are:
  2285.  
  2286.             Com Port 1 :    3F8
  2287.             Com Port 2 :    2F8
  2288.             Com Port 3 :    3E8
  2289.             Com Port 4 :    2E8   (not so common)
  2290.  
  2291.  
  2292.     The "/IRQ" Command Line Option              minimum abbreviation:  "/I"
  2293.     ──────────────────────────────
  2294.  
  2295.     This option is used to tell SHARECOM the IRQ line used by the Com Port
  2296.     that is to be Opened.
  2297.  
  2298.     The use of this option implies the "/OPEN" option, which means that if
  2299.     this option is used, SHARECOM will assume that you are trying to Open a
  2300.     Com Port, whether the "/OPEN" option was specified or not.
  2301.  
  2302.     It requires a numeric parameter value between 1 and 15 inclusive, which
  2303.     represents the IRQ used by the Com Port that is to be Opened.
  2304.  
  2305.     Ordinarily, the use of this option when Opening either Com Port 1 or 2
  2306.     is unnecessary, because those Ports are almost always configured to use
  2307.     IRQ 4 and 3, respectively, which is the default values used by the
  2308.     SHARECOM program for those Ports.
  2309.  
  2310.     This option must be specified however, when Opening either Com Port 3 or
  2311.     Com Port 4, as SHARECOM does not have default IRQ's for those Ports.
  2312.  
  2313.     THE COMSHARE SYSTEM                       MAKING A COM PORT SHAREABLE   40
  2314.  
  2315.  
  2316.  
  2317.     This option may also need to be specified when Opening Com Ports 1 or 2,
  2318.     if their IRQ settings were changed from their default values through the
  2319.     use of dip switches on the Serial Card itself.
  2320.  
  2321.     In any event, if this option is not specified when Opening a Com Port,
  2322.     the SHARECOM program will report an error if no default value exists.
  2323.  
  2324.     If SHARECOM does report such an error, this option must be used to input
  2325.     the correct value, which can normally be obtained from the Serial Card
  2326.     documentation.
  2327.  
  2328.  
  2329.     The "/GRAD" Command Line Option             minimum abbreviation:  "/G"
  2330.     ───────────────────────────────
  2331.  
  2332.     This option is used to tell SHARECOM what GRAD number to assign to the
  2333.     GRAD that is created when the Com Port is Opened.
  2334.  
  2335.     The use of this option implies the "/OPEN" option, which means that if
  2336.     this option is used, SHARECOM will assume that you are trying to Open a
  2337.     Com Port, whether the "/OPEN" option was specified or not.
  2338.  
  2339.     It requires a numeric parameter value greater than zero and less than or
  2340.     equal to the largest GRAD number possible, which would be 2 for a 2-Port
  2341.     License, 5 for a 5-Port License, etc.
  2342.  
  2343.     If this option is not specified when Opening a Com Port, the GRAD number
  2344.     of the created GRAD will be assigned the lowest possible GRAD number that
  2345.     doesn't already exist on the network.
  2346.  
  2347.     If a GRAD already exists on the network with the same GRAD number as that
  2348.     specified by this option, SHARECOM will keep incrementing the GRAD number
  2349.     by one, until either an unused GRAD number is found, or no more GRAD
  2350.     numbers can be assigned according to the License.
  2351.  
  2352.  
  2353.     The "/FLOW" Command Line Option             minimum abbreviation:  "/F"
  2354.     ───────────────────────────────
  2355.  
  2356.     This option is used to tell SHARECOM what flow control method the created
  2357.     GRAD will be using when communicating with the outside world (which
  2358.     usually means over the phone lines).
  2359.  
  2360.     "Flow Control" is the strategy employed by the GRAD when data coming in
  2361.     from the outside world (ie: NOT the network traffic) comes in faster than
  2362.     the GRAD can process it.
  2363.  
  2364.     The use of this option implies the "/OPEN" option, which means that if
  2365.     this option is used, SHARECOM will assume that you are trying to Open a
  2366.     Com Port, whether the "/OPEN" option was specified or not.
  2367.  
  2368.     It requires a textual parameter value that can be either "HARD", "SOFT",
  2369.     or "NONE", designating Hardware Flow Control, Software Flow Control, or
  2370.     No Flow Control, respectively (see below for explanations of these terms).
  2371.  
  2372.     THE COMSHARE SYSTEM                       MAKING A COM PORT SHAREABLE   41
  2373.  
  2374.  
  2375.  
  2376.     The required parameter is not only case insensitive, it can also, if
  2377.     desired, be truncated to one or more letters.
  2378.  
  2379.     If this option is not specified when Opening a Com Port, the default flow
  2380.     control method will be used, which is Hardware Flow Control.  If the
  2381.     installed Serial Card attached to the Com Port cannot use Hardware Flow
  2382.     Control (see below), then this option must be used to change the flow
  2383.     control to a more suitable choice, or the results will be unpredictable.
  2384.  
  2385.     Each possible flow control method is the strategy employed by the GRAD
  2386.     when data coming in along its "RECEIVE" line arrives faster than the GRAD
  2387.     is able to process it.
  2388.  
  2389.     There are three possible strategies to choose from, which are:
  2390.  
  2391.     Hardware Flow Control - in this strategy, if data coming in along the
  2392.                             GRAD's "RECEIVE" line arrives faster than the
  2393.                             GRAD can process it, the GRAD will force the
  2394.                             hardware "RTS" line low (ie: it will clear RTS) in
  2395.                             the hopes that the sending side will recognize
  2396.                             this as the signal to stop sending data.  When the
  2397.                             GRAD is ready to resume receiving data again, it
  2398.                             will then force the RTS line high, which will then
  2399.                             (hopefully?) signal the sending side to resume
  2400.                             sending data.
  2401.  
  2402.                             Practically all MODEMS made that can operate at
  2403.                             baud rates of 9600 and above can use this method.
  2404.                             If there is any doubt, the modem documentation
  2405.                             should be consulted.
  2406.  
  2407.                             To make a long story short, this is the flow
  2408.                             control method that should be chosen for MODEMS
  2409.                             that can handle baud rates of 9600 and above, as
  2410.                             it is by far the most efficient and foolproof
  2411.                             method of flow control available.
  2412.  
  2413.     Software Flow Control - in this strategy, if data coming in along the
  2414.                             GRAD's "RECEIVE" line arrives faster than the
  2415.                             GRAD can process it, the GRAD will send a special
  2416.                             character to the sending side, called an "XOFF"
  2417.                             character, in the hopes that the sending side will
  2418.                             recognize this as the signal to stop sending data.
  2419.                             When the GRAD is ready to resume receiving data
  2420.                             again, it will then send out another special
  2421.                             character, called an "XON" character, which will
  2422.                             then (hopefully?) signal the sending side to
  2423.                             resume sending data.
  2424.  
  2425.                             This is a very poor method of flow control because
  2426.                             it generally only works for ASCII-based data, and
  2427.                             will therefore not work for binary file transfers
  2428.                             other than perhaps those using the XModem or
  2429.                             Kermit file transfer protocols.  It can work quite
  2430.                             effectively for mainframe communications however.
  2431.  
  2432.     THE COMSHARE SYSTEM                       MAKING A COM PORT SHAREABLE   42
  2433.  
  2434.  
  2435.  
  2436.                             If the GRAD is expected to perform binary data
  2437.                             transfers then, at baud rates of 2400 or less, it
  2438.                             would probably be best to choose "None" as the
  2439.                             flow control method (see below).
  2440.  
  2441.     None - in this strategy, if data coming in along the GRAD's "RECEIVE"
  2442.            line arrives faster than the GRAD can process it, the GRAD will
  2443.            simply ignore all data that it cannot handle.  This may cause
  2444.            characters to be lost, but assuming that the baud rate of the
  2445.            incoming characters will be at 2400 baud or less for this method
  2446.            to have been chosen at all, the likelihood of data coming in fast
  2447.            enough for this to happen is extremely small (ie: 2400 baud is
  2448.            considered *slow* for SHARECOM).  If you are using a very slow
  2449.            machine however, such as a 286 running at 8 Mhz or less, the
  2450.            possibility increases that characters may be lost when using this
  2451.            strategy.
  2452.  
  2453.  
  2454.     The "/PASS" Command Line Option             minimum abbreviation:  "/P"
  2455.     ───────────────────────────────
  2456.  
  2457.     This option is used to assign a password to the GRAD that is created when
  2458.     the Com Port is Opened.
  2459.  
  2460.     If a GRAD is assigned a password, all attempts to use, or "connect" to it
  2461.     will fail unless the exact same password is used when the attempt is made,
  2462.     mechanisms for which exist in both the USECOM and PICKCOM programs.
  2463.  
  2464.     The use of this option implies the "/OPEN" option, which means that if
  2465.     this option is used, SHARECOM will assume that you are trying to Open a
  2466.     Com Port, whether the "/OPEN" option was specified or not.
  2467.  
  2468.     This option requires a parameter value, which is the password that is
  2469.     to be assigned to the created GRAD, and is case sensitive.  It can be
  2470.     enclosed in quotation marks, which will not be considered as part of the
  2471.     password, and MUST be enclosed in quotation marks if the password contains
  2472.     any spaces or tabs.  If it is desired that the password contain quotation
  2473.     marks, each must be preceded by a '\' character, which will not be
  2474.     contained in the final password.
  2475.  
  2476.     Any number of characters may be specified for the password, but only the
  2477.     first 20 will be significant; the remainder will be discarded (a '\"'
  2478.     combination is considered one character).
  2479.  
  2480.     When using this option, one or more spaces must exist between the end of
  2481.     its parameter value (the password) and the next specified option, if it
  2482.     exists, or the latter will be taken as part of the password.
  2483.  
  2484.  
  2485.     The "/TEXT" Command Line Option             minimum abbreviation:  "/T"
  2486.     ───────────────────────────────
  2487.  
  2488.     This option is used to assign a description to the GRAD that is created
  2489.     when the Com Port is Opened.
  2490.  
  2491.     THE COMSHARE SYSTEM                       MAKING A COM PORT SHAREABLE   43
  2492.  
  2493.  
  2494.  
  2495.     The description, if specified, will be attached to the GRAD and will
  2496.     appear next to the GRAD number in the PICKCOM program's menu of available
  2497.     GRADs.  Its purpose is to provide distinctive information about the GRAD
  2498.     that might be pertinent or expedient to the GRAD selection process.
  2499.  
  2500.     The use of this option implies the "/OPEN" option, which means that if
  2501.     this option is used, SHARECOM will assume that you are trying to Open a
  2502.     Com Port, whether the "/OPEN" option was specified or not.
  2503.  
  2504.     This option requires a parameter value, which is the text of the
  2505.     description itself, and is case sensitive.  It can be enclosed in
  2506.     quotation marks, which will not be considered as part of the description,
  2507.     and MUST be enclosed in quotation marks if the description contains any
  2508.     spaces or tabs.  If it is desired that the description contain quotation
  2509.     marks, each must be preceded by a '\' character, which will not be
  2510.     contained in the final description.
  2511.  
  2512.     Any number of characters may be specified for the description, but only
  2513.     the first 56 will be significant; the remainder will be discarded (a '\"'
  2514.     combination is considered one character).
  2515.  
  2516.     When using this option, one or more spaces must exist between the end
  2517.     of its parameter value (the description) and the next specified option,
  2518.     if it exists, or the latter will be taken as part of the description.
  2519.  
  2520.  
  2521.     Closing A Com Port
  2522.     ──────────────────
  2523.  
  2524.     When the SHARECOM program Closes a Com Port, it first checks the current
  2525.     state of that Com Port.  If it is not Open, or its character buffer
  2526.     cannot be released (see "Memory Considerations", above), the attempt is
  2527.     aborted and an error is reported.
  2528.  
  2529.     If it is "In Session", the network connection is first terminated before
  2530.     it is Closed.  Once the Com Port has been Closed, a one-line status
  2531.     message is displayed to the console, confirming the closure.
  2532.  
  2533.     Although Closing a Com Port will release the character buffer appropriated
  2534.     for that Com Port, it will not release the resident program code required
  2535.     to manage the GRADs.  For that to be released, the "/DISABLE" or
  2536.     /"SHUTDOWN" options may be used.
  2537.  
  2538.     If the Com Port number is unspecified on the command line, SHARECOM will
  2539.     attempt to Close the Com Port that was last Opened.
  2540.  
  2541.     There is only one command line option available to Close a Com Port,
  2542.     which is:
  2543.  
  2544.  
  2545.     The "/CLOSE" Command Line Option            minimum abbreviation:  "/C"
  2546.     ────────────────────────────────
  2547.  
  2548.     Specifying this option causes SHARECOM to Close a Com Port.
  2549.     It does not take a parameter value.
  2550.  
  2551.     THE COMSHARE SYSTEM                       MAKING A COM PORT SHAREABLE   44
  2552.  
  2553.  
  2554.  
  2555.     Ascertaining The Status
  2556.     ───────────────────────
  2557.  
  2558.     As far as the SHARECOM program is concerned, "Ascertaining the Status"
  2559.     means to ascertain the relevant information about each of the four Com
  2560.     Ports on a single machine.
  2561.  
  2562.     There is only one command line option available to Ascertain the Status,
  2563.     which is:
  2564.  
  2565.  
  2566.     The "/STATUS" Command Line Option           minimum abbreviation:  "/S"
  2567.     ─────────────────────────────────
  2568.  
  2569.     Specifying this option causes SHARECOM to display to the console a "Com
  2570.     Port Status" screen, once all other command line option requests have been
  2571.     fulfilled.  If no other options are present on the command line, then the
  2572.     SHARECOM program will simply display to the console the Com Port Status
  2573.     screen and exit.
  2574.  
  2575.     The Com Port Status screen is basically a chart of sorts, which displays
  2576.     information specific to each of the four Com Ports that exist on a single
  2577.     machine.
  2578.  
  2579.     An example Com Port Status screen might look like this, with minor
  2580.     differences in the header for the Registered version(s):
  2581.  
  2582.  
  2583.      ╒═════════════════════════════════════════════════════════════════╕
  2584.      │        ╒═══╕  │                       ╒═══╕               (TM)  │
  2585.      │        ╘═══╕  ╞══╕   ══╕  ╒══╕  ╒══╕  │      ╒══╕  ╒═╤═╕        │░░
  2586.      │   ═══      │  │  │  ╒══╡  │     ╞══╛  │      │  │  │ │ │  ═══   │░░
  2587.      │        ╘═══╛  ┴  ┴  ╘══╛  ┴     ╘══   ╘═══╛  ╘══╛  ┘ ┴ └        │░░
  2588.      ╞═════════════════════════════════════════════════════════════════╡░░
  2589.      │     - Network Telecommunications Resource Sharing Utility -     │░░
  2590.      │ NETBIOS Version 1.00       2-Port License      License # T00000 │░░
  2591.      │ Copyright (c) 1994, David A. Stephenson & NashaKala Corporation │░░
  2592.      │                - All rights reserved worldwide -                │░░
  2593.      ├─────────────────────────────────────────────────────────────────┤░░
  2594.      │ TRYWARE VERSION:  << Network Connection will last 30 minutes >> │░░
  2595.      ╞═════════════════════════════════════════════════════════════════╡░░
  2596.      │                   ***** Com Port Status *****                   │░░
  2597.      ╞════════╤═══════╤═════════╤══════════════╤══════════════╤════════╡░░
  2598.      │  Com   │       │  Port   │ Flow Control │   Current    │  GRAD  │░░
  2599.      │  Port  │  IRQ  │ Address │    Method    │    Status    │ number │░░
  2600.      ╞════════╪═══════╪═════════╪══════════════╪══════════════╪════════╡░░
  2601.      │   1    │   4   │   3F8   │      -       │ INACCESSIBLE │   --   │░░
  2602.      │   2    │   3   │   2F8   │   XON/XOFF   │   - OPEN -   │   02   │░░
  2603.      │   3    │  11   │   3E8   │     NONE     │  IN SESSION  │   01   │░░
  2604.      │   4    │   -   │    -    │   HARDWARE   │   NOT OPEN   │   --   │░░
  2605.      └─────────────────────────────────────────────────────────────────┘░░
  2606.         ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
  2607.  
  2608.     THE COMSHARE SYSTEM                       MAKING A COM PORT SHAREABLE   45
  2609.  
  2610.  
  2611.  
  2612.     As can be seen from the above example, if one or more pieces of
  2613.     information about a particular Com Port is unknown or indeterminate, one
  2614.     or more consecutive dashes will appear where the information would have
  2615.     been given.
  2616.  
  2617.     An explanation of each of the column headings follows:
  2618.  
  2619.     "Com Port"  -  is the Com Port number.
  2620.  
  2621.     "IRQ"  -  is the IRQ that the Com Port is assumed to be using
  2622.               (see the "/IRQ" command line option for more information).
  2623.  
  2624.               If the Com Port is not a GRAD, the value shown is the default
  2625.               that will be used in the absence of an option specification.
  2626.  
  2627.     "Port Address"  -  is the Hexidecimal (base 16) Com Port address assumed
  2628.                        for the Com Port (see the "/ADDR" command line option
  2629.                        for more information).
  2630.  
  2631.                        If the Com Port is not a GRAD, the value shown is the
  2632.                        default that will be used in the absence of an option
  2633.                        specification.
  2634.  
  2635.     "Flow Control Method"  -  is the flow control method employed by the
  2636.                               SHARECOM program on behalf of the Com Port.
  2637.  
  2638.                               If the Com Port is not a GRAD, the value shown
  2639.                               is the default that will be used in the absence
  2640.                               of an option specification.
  2641.  
  2642.                               "XON/XOFF" refers to Software Flow Control,
  2643.                               "HARDWARE" refers to Hardware Flow Control, and
  2644.                               "NONE" indicates that no flow control is being
  2645.                               employed for the Com Port (see the "/FLOW"
  2646.                               command line option for more information).
  2647.  
  2648.     "Current Status"  -  is the current status of the Com Port:
  2649.  
  2650.                          "- OPEN -" means that the Com Port is shareable;
  2651.                          that is, it has been made into a GRAD, but is not
  2652.                          currently connected, and is therefore available to
  2653.                          connect to.
  2654.  
  2655.                          "NOT OPEN" means that the Com Port is not shareable;
  2656.                          it is an ordinary Com Port, and can therefore either
  2657.                          be used as such, or Opened by the SHARECOM program.
  2658.  
  2659.                          "IN SESSION" means that the Com Port has not only
  2660.                          been made into a GRAD, but that it is currently
  2661.                          connected across the network to another (or the
  2662.                          same) machine;  ie: it is currently being accessed.
  2663.  
  2664.                          "INACCESSIBLE" means that the Com Port is currently
  2665.                          being used by another process or program, and is
  2666.                          therefore unavailable for use by the SHARECOM
  2667.                          program.  A Com Port with a mouse, for instance,
  2668.  
  2669.     THE COMSHARE SYSTEM                       MAKING A COM PORT SHAREABLE   46
  2670.  
  2671.  
  2672.  
  2673.                          would fall into this category.
  2674.  
  2675.     "GRAD number"  -  is the GRAD number of the GRAD that the Com Port was
  2676.                       made from.  This number will only appear if the
  2677.                       "Current Status" of the Com Port is either "- OPEN -"
  2678.                       or "IN SESSION".
  2679.  
  2680.  
  2681.     Other Options
  2682.     ─────────────
  2683.  
  2684.     Most of the SHARECOM program's remaining available command line options
  2685.     are concerned with managing those parts of resident memory which are
  2686.     not used as character buffers, which primarily refers to that part of
  2687.     resident memory which holds the actual machine instructions, known as
  2688.     "code", required to manage the created GRADs in the background.
  2689.  
  2690.     There are four remaining command line options available to use with the
  2691.     SHARECOM program, which are:
  2692.  
  2693.  
  2694.     The "/LOAD" Command Line Option             minimum abbreviation:  "/L"
  2695.     ───────────────────────────────
  2696.  
  2697.     Specifying this option causes SHARECOM to load the program code needed
  2698.     to manage GRADs in the background into resident memory, but not to Open
  2699.     or Close any Com Ports.  All subsequent requests to Open a Com Port will
  2700.     therefore only require another 2-3K of resident memory each, providing
  2701.     the "/DISABLE" or "/SHUTDOWN" options have not been used in the interim.
  2702.  
  2703.     This option does not take a parameter value.
  2704.  
  2705.     If this option is specified and the SHARECOM program's resident code is
  2706.     already resident in memory, from either a previous "/OPEN", or a previous
  2707.     "/LOAD" command, then SHARECOM will generate an appropriate error message
  2708.     and exit, unless other options exist on the command line which render it
  2709.     superfluous, such as "/OPEN" or "/CLOSE", in which case it will simply be
  2710.     ignored.
  2711.  
  2712.     One of the possible uses of this command line option might be to load
  2713.     SHARECOM's program code into DOS's HIGH memory area through the use of
  2714.     the DOS "LoadHigh" command in order to save conventional memory, which
  2715.     could even be done from within your AUTOEXEC.BAT file, assuming that the
  2716.     network software was installed by then.
  2717.  
  2718.  
  2719.     The "/GUARD" Command Line Option            minimum abbreviation:  "/G"
  2720.     ────────────────────────────────
  2721.  
  2722.     Specifying this option causes SHARECOM to load the program code needed
  2723.     to install the "Guard", which is a memory resident extension to the
  2724.     SHARECOM functionality that displays a pop-up warning notice to the
  2725.     console if the CTRL-ALT-DEL key combination is pressed while one or more
  2726.     Com Ports are "In Session".
  2727.  
  2728.     This option does not take a parameter value.
  2729.  
  2730.     THE COMSHARE SYSTEM                       MAKING A COM PORT SHAREABLE   47
  2731.  
  2732.  
  2733.  
  2734.     Once the "Guard" is installed, if the CTRL-ALT-DEL key combination is
  2735.     pressed while one or more Com Ports are "In Session", the following
  2736.     warning notice will appear in approximately the center of the screen:
  2737.  
  2738.              ┌──────────────────────────────────────────────────────┐
  2739.              │ Warning!  Communication Session(s) Established.      │
  2740.              │ Press any key to cancel or CTRL-ALT-DEL to Reboot... │
  2741.              └──────────────────────────────────────────────────────┘
  2742.  
  2743.     the meaning of which should be self-explanatory.
  2744.  
  2745.     This option can only be used in conjunction with those options which
  2746.     cause the SHARECOM program to load its resident code into memory for the
  2747.     first time.  Therefore, if this option is specified and the SHARECOM
  2748.     program's resident code is already resident in memory, from either a
  2749.     previous "/OPEN", or a previous "/LOAD" command, then it will be ignored.
  2750.  
  2751.     The use of this option implies the "/LOAD" option, which means that if
  2752.     this option is used without a corresponding "/LOAD" or "/OPEN" command
  2753.     line option, then the "/LOAD" option will be assumed.
  2754.  
  2755.  
  2756.     The "/DISABLE" Command Line Option          minimum abbreviation:  "/D"
  2757.     ──────────────────────────────────
  2758.  
  2759.     Specifying this option causes SHARECOM to effectively disable all of
  2760.     SHARECOM's resident functionality by Closing all Open Com Ports, and
  2761.     releasing all resident memory taken up by previous invocations of the
  2762.     SHARECOM program, which includes all resident code and buffers, but
  2763.     ONLY if:
  2764.  
  2765.     1)  No Open Com Ports (GRADs) are "In Session", and
  2766.     2)  All resident code and buffers can be released
  2767.         (see "Memory Considerations" above).
  2768.  
  2769.     If either or both of these stipulations cannot be met, the SHARECOM
  2770.     program will exit with an appropriate error message, the status of all
  2771.     Com Ports will remain unchanged, and all resident memory will remain
  2772.     intact.  In short, if the request fails, no damage will have been done.
  2773.  
  2774.     This option does not take a parameter value.
  2775.  
  2776.  
  2777.     The "/SHUTDOWN" Command Line Option         minimum abbreviation:  "/SH"
  2778.     ───────────────────────────────────
  2779.  
  2780.     This command line option is exactly like the "/DISABLE" command line
  2781.     option (above), except that it will work *even if* one or more Com Ports
  2782.     are "In Session".  If an Open Com Port (a GRAD) is "In Session", the
  2783.     connection will be terminated before the Com Port is Closed.
  2784.  
  2785.     THE COMSHARE SYSTEM                        USING A SHAREABLE COM PORT   48
  2786.  
  2787.  
  2788.  
  2789.     USING A SHAREABLE COM PORT
  2790.     ══════════════════════════════════════════════════════════════════════════
  2791.  
  2792.  
  2793.     This section of the documentation assumes that you have read at least the
  2794.     "Theory & Nomenclature" sub-section of the "GETTING STARTED" section of
  2795.     this documentation, as most of the key terms used here are defined there.
  2796.  
  2797.  
  2798.     The USECOM Program
  2799.     ──────────────────
  2800.  
  2801.     The USECOM program can be used to:
  2802.  
  2803.     1) connect a local Com Port to an available GRAD on the network,
  2804.     2) disconnect a Com Port from the GRAD it is attached to, or
  2805.     3) provide machine-specific status information.
  2806.  
  2807.     The first two of the above functions requires a separate invocation of
  2808.     the USECOM program; the third can be performed either separately or in
  2809.     conjunction with the other two.  For example, to connect, or attach, two
  2810.     separate Com Ports on a single machine to two separate GRADs on the
  2811.     network would require, at a minimum, two separate invocations of the
  2812.     USECOM program (one for each Com Port), each of which may or may not be
  2813.     accompanied by status information.
  2814.  
  2815.     The first of the three above listed functions of the USECOM program, that
  2816.     of connecting a single Com Port to an existing GRAD, is called "Opening
  2817.     a Com Port".  The second of the three is called "Closing a Com Port", and
  2818.     the third is known as "Ascertaining the Status".  The definitions of these
  2819.     terms are specific to the USECOM program however, as they have different
  2820.     meanings when used in the context of the SHARECOM program.
  2821.  
  2822.     Communication with the USECOM program is done exclusively through its
  2823.     command line, and consists of zero or more "options", followed by an
  2824.     optional Com Port number.
  2825.  
  2826.     The optional Com Port number, if specified, must be a single digit
  2827.     decimal number between 1 and 4 inclusive, which represents the Com Port
  2828.     number of the Com Port you wish acted upon.  If not specified, the
  2829.     USECOM program will attempt to perform the requested function on the
  2830.     first Com Port it finds that is valid in the context of the requested
  2831.     function it is being asked to perform.
  2832.  
  2833.     Each "option" on the command line is a unique text string which serves
  2834.     to specify either what or how an action is to be performed.  Each option
  2835.     on the command line must be preceded by either a '/' or a '-' character
  2836.     for it to be recognized by the USECOM program as an option, otherwise
  2837.     it will be interpreted as a Com Port number.
  2838.  
  2839.     For convenience, each option on the command line may be abbreviated to
  2840.     the least number of characters necessary to resolve ambiguity with any
  2841.     other option.  The option, "/OPEN", for example, may be abbreviated to
  2842.     "/O", because no other option starts with an "O", but the minimum
  2843.     abbreviation for the "/SHUTDOWN" option, for example, must be "/SH",
  2844.     because anything less might be interpreted as the "/STATUS" option.
  2845.  
  2846.     THE COMSHARE SYSTEM                        USING A SHAREABLE COM PORT   49
  2847.  
  2848.  
  2849.  
  2850.     Some options require parameter values to be specified, which may be
  2851.     textual or numeric, depending on the option.  If an option does require
  2852.     a parameter value, then either an '=' or a ':' character must exist
  2853.     between it and the parameter value, with no spaces in between, such as
  2854.     in "/GRAD=2", or "/START:5".
  2855.  
  2856.     All of USECOM's command line options are case insensitive.  Specifying
  2857.     "/OpEn" is equivalent to specifying, "/oPeN", for example.  Option
  2858.     parameter values however, may or may not be case sensitive, depending on
  2859.     the requirements of the option itself.
  2860.  
  2861.     Spaces or tabs may exist between options, but are only necessary following
  2862.     those options which take parameters.
  2863.  
  2864.     Once the USECOM program has been successfully invoked, it will then
  2865.     return control back to the DOS prompt, at which point the machine can be
  2866.     used as it normally would be.
  2867.  
  2868.  
  2869.     Memory Considerations
  2870.     ─────────────────────
  2871.  
  2872.     Resident memory management is handled in a slightly different way in
  2873.     the USECOM program from that contained in the SHARECOM program and, I
  2874.     suppose I should admit, a slightly more intelligent way.
  2875.  
  2876.     Just like the SHARECOM program however, the USECOM program must leave a
  2877.     piece of itself in memory after it has been invoked to Open a Com Port.
  2878.     This "piece of memory" consists of the part of the USECOM program that
  2879.     will operate in the background managing communication with the GRADs it
  2880.     will attach to, which is about 4K in size, and a resident character buffer
  2881.     of approximately 2K for the NetBIOS version, 3K for the IPX/SPX version,
  2882.     for holding any incoming and outgoing characters.
  2883.  
  2884.     Once the first Com Port has been Opened however, any Com Ports
  2885.     subsequently Opened by the USECOM program on the same machine will only
  2886.     require another 2-3K of memory - for the new Com Port's character buffer.
  2887.  
  2888.     When Closing a Com Port, the USECOM program's method of handling resident
  2889.     memory differs markedly from the SHARECOM program, in that it does NOT
  2890.     attempt to release the Com Port's resident character buffer.
  2891.  
  2892.     What this means is that it's possible to Open two Com Ports with the
  2893.     USECOM program, one after the other, then proceed to Close the first one
  2894.     that was Opened (presumably after using it), while the second is still
  2895.     Open.  The first Opened Com Port's character buffer is still trapped
  2896.     beneath the second's buffer, but since no attempt is made to release it,
  2897.     there is no problem.
  2898.  
  2899.     In this particular case, what you will end up with is two buffers in
  2900.     memory, one which is not being used, and one which is.
  2901.  
  2902.     However, because the USECOM program is smart enough to know that the
  2903.     unused buffer is not currently being used, the next time it is asked to
  2904.     Open another Com Port, instead of creating a new character buffer for the
  2905.     newly Opened Com Port, it will simply use the old one.
  2906.  
  2907.     THE COMSHARE SYSTEM                        USING A SHAREABLE COM PORT   50
  2908.  
  2909.  
  2910.  
  2911.     If, on the other hand, instead of Opening another Com Port, you chose to
  2912.     Close the one remaining Opened Com Port, then there would be two unused
  2913.     character buffers in memory, doing nothing but soaking up precious
  2914.     conventional memory.
  2915.  
  2916.     In that case however, the USECOM program can again be fortuitously
  2917.     employed by invoking it with the "/RELEASE" option, which releases all
  2918.     "freeable" buffers.  A "freeable" buffer is any unused character buffer
  2919.     existing in resident memory that is not trapped underneath any other
  2920.     block or blocks of resident memory.
  2921.  
  2922.     One of the advantages of using this method of managing the Opened Com
  2923.     Port's resident character buffers, as opposed to the way in which the
  2924.     SHARECOM program manages them, is that Com Ports can be Opened and Closed
  2925.     at will, without regard for where their particular character buffers exist
  2926.     in resident memory.
  2927.  
  2928.     This ability of the USECOM program to sniff out and use any unused
  2929.     character buffers that may exist in resident memory can also be exploited
  2930.     quite effectively to force an Opened Com Port to use an area of memory
  2931.     that, for one reason or another, may not otherwise be accessible when the
  2932.     Com Port is Opened.  In fact, it is just this capability that allows the
  2933.     USECOM program to operate under Windows 3.1, the particulars for which are
  2934.     further explained in APPENDIX B.
  2935.  
  2936.     The one disadvantage to this method of course, is that when a Com Port is
  2937.     Closed, its resident character buffer remains in memory.  With judicious
  2938.     use of the aforementioned "/RELEASE" command line option however, this
  2939.     should not present much of a problem.
  2940.  
  2941.  
  2942.     Opening A Com Port
  2943.     ──────────────────
  2944.  
  2945.     When the USECOM program Opens a Com Port, a series of actions are
  2946.     initiated which all must be successful before the Com Port is Opened.
  2947.     If an error occurs during any one of these actions, USECOM will abort
  2948.     the entire attempt with an appropriate error message, and exit.
  2949.  
  2950.     The series of actions, in the order in which they are performed, are:
  2951.  
  2952.     1)  IF the USECOM program's resident code is not already in memory, from
  2953.         either a previous "/OPEN", "/LOAD", or "/BUFFER" command, then the
  2954.         USECOM program will attempt to "Register the Node" which, in essence,
  2955.         means creating a network address for the machine that it is running
  2956.         on for the purposes of communicating to other machines on the network.
  2957.  
  2958.     2)  The entire network is then searched for a GRAD to attach to which
  2959.         matches the criteria given or assumed from the options existent on
  2960.         the command line.  If any GRAD is found that is currently In Session,
  2961.         the connection attempt will fail.  If the "/GRAD" option is used, the
  2962.         search will only include the GRAD number specified by that option,
  2963.         otherwise as many as ten (10) GRAD numbers will be queried, starting
  2964.         with either GRAD number 1 or, if present, the GRAD number specified
  2965.         by the "/START" option.
  2966.  
  2967.     THE COMSHARE SYSTEM                        USING A SHAREABLE COM PORT   51
  2968.  
  2969.  
  2970.  
  2971.     3)  Resident memory is then searched for an unused character buffer
  2972.         which, if found, will be used by the Opened Com Port. If none are
  2973.         found, a new resident character buffer is allocated.  If more than
  2974.         one exists in memory, the one "lowest" in memory will be used.  The
  2975.         Com Port is then Opened.
  2976.  
  2977.     Before performing any of the above actions, except for the last one, the
  2978.     USECOM program will display to the console a one-line status message
  2979.     indicative of the action it is about to perform.  Upon successful
  2980.     completion of all of the actions, a confirmation of the Open is then
  2981.     displayed.
  2982.  
  2983.     If the Com Port number is unspecified on the command line, USECOM will
  2984.     attempt to Open the first available unopened Com Port, starting with Com
  2985.     Port 1, until all four Com Ports have been tried.
  2986.  
  2987.     To Open a Com Port, the following command line options may be used:
  2988.  
  2989.  
  2990.     The "/OPEN" Command Line Option             minimum abbreviation:  "/O"
  2991.     ───────────────────────────────
  2992.  
  2993.     Specifying this option causes USECOM to attempt to Open a Com Port.
  2994.     It does not take a parameter value.
  2995.  
  2996.  
  2997.     The "/START" Command Line Option            minimum abbreviation:  "/S"
  2998.     ────────────────────────────────
  2999.  
  3000.     This option is used to tell the USECOM program what GRAD number to begin
  3001.     searching for when it searches the network looking for an available GRAD
  3002.     to attach to.
  3003.  
  3004.     The use of this option implies the "/OPEN" option, which means that if
  3005.     this option is used, SHARECOM will assume that you are trying to Open a
  3006.     Com Port, whether the "/OPEN" option was specified or not.
  3007.  
  3008.     It requires a numeric parameter value greater than zero and less than or
  3009.     equal to the largest GRAD number possible, which would be 2 for a 2-Port
  3010.     License, 5 for a 5-Port License, etc.
  3011.  
  3012.     If this option is used, the USECOM program will attempt to attach to the
  3013.     GRAD whose GRAD number is specified by this option, and if unsuccessful,
  3014.     will then try the next ten (10) GRAD numbers in succession, until either
  3015.     one of them can be attached to, or all ten have been tried.
  3016.  
  3017.     If this option is not specified when Opening a Com Port, its default
  3018.     value will be assumed, which is GRAD number 1, unless the "/GRAD" option
  3019.     is used (see below).
  3020.  
  3021.     THE COMSHARE SYSTEM                        USING A SHAREABLE COM PORT   52
  3022.  
  3023.  
  3024.  
  3025.     The "/GRAD" Command Line Option             minimum abbreviation:  "/G"
  3026.     ───────────────────────────────
  3027.  
  3028.     This command line option is exactly like the "/START" command line
  3029.     option (above), except that if the GRAD whose GRAD number is specified by
  3030.     this option cannot be attached to, no further GRADs will be tried, and
  3031.     the USECOM program will simply report the failure and exit.
  3032.  
  3033.     Also, if both this option and the "/START" option (above) are not present
  3034.     on the command line, the "/START" option with its default value will be
  3035.     assumed.
  3036.  
  3037.  
  3038.     The "/PASS" Command Line Option             minimum abbreviation:  "/P"
  3039.     ───────────────────────────────
  3040.  
  3041.     This option is used to tell the USECOM program what password to use when
  3042.     attempting to attach to any GRAD that requires a password.
  3043.  
  3044.     If a GRAD requires a password which is different in any way from that
  3045.     specified by this option, the connection attempt will fail.  If a GRAD
  3046.     does not require a password and one is specified by this option, the
  3047.     connection attempt will proceed irrespective of any value specified by
  3048.     this option.
  3049.  
  3050.     The use of this option implies the "/OPEN" option, which means that if
  3051.     this option is used, USECOM will assume that you are trying to Open a
  3052.     Com Port, whether the "/OPEN" option was specified or not.
  3053.  
  3054.     This option requires a parameter value, which is the password that is
  3055.     to be used, and is case sensitive.  It can be enclosed in quotation marks,
  3056.     which will not be considered as part of the password, and MUST be enclosed
  3057.     in quotation marks if the password contains any spaces or tabs.  If it is
  3058.     desired that the password contain quotation marks, each must be preceded
  3059.     by a '\' character, which will not be contained in the final password.
  3060.  
  3061.     Any number of characters may be specified for the password, but only the
  3062.     first 20 will be significant; the remainder will be discarded (a '\"'
  3063.     combination is considered one character).
  3064.  
  3065.     When using this option, one or more spaces must exist between the end of
  3066.     its parameter value (the password) and the next specified option, if it
  3067.     exists, or the latter will be taken as part of the password.
  3068.  
  3069.  
  3070.     Closing A Com Port
  3071.     ──────────────────
  3072.  
  3073.     When the USECOM program Closes a Com Port, it first checks the current
  3074.     state of that Com Port.  If it is not Open, the attempt is aborted and
  3075.     an error is reported.  Once the Com Port has been Closed, a one-line
  3076.     status message is displayed to the console, confirming the closure.
  3077.  
  3078.     When the USECOM program Closes a Com Port, the resident character buffer
  3079.     is not released.  If desired, it and all other "freeable" buffers can be
  3080.     released by using the "/RELEASE" command line option either at the time
  3081.  
  3082.     THE COMSHARE SYSTEM                        USING A SHAREABLE COM PORT   53
  3083.  
  3084.  
  3085.  
  3086.     of, or subsequent to, the closure.  If it is desired to also release the
  3087.     USECOM program's resident code, the /"SHUTDOWN" option may be used.
  3088.  
  3089.     If the Com Port number is unspecified on the command line, USECOM
  3090.     will attempt to Close the Com Port whose resident character buffer is
  3091.     "highest" in memory (ie: the one least likely to be using a buffer that
  3092.     is "trapped" under any other buffers).
  3093.  
  3094.     There is only one command line option available to Close a Com Port,
  3095.     which is:
  3096.  
  3097.  
  3098.     The "/CLOSE" Command Line Option            minimum abbreviation:  "/C"
  3099.     ────────────────────────────────
  3100.  
  3101.     Specifying this option causes USECOM to Close a Com Port.
  3102.     It does not take a parameter value.
  3103.  
  3104.  
  3105.     Ascertaining The Status
  3106.     ───────────────────────
  3107.  
  3108.     Unlike the SHARECOM program's Status screen, the USECOM program's
  3109.     Status screen provides information about two distinct aspects of its
  3110.     functionality.
  3111.  
  3112.     In addition to providing information about the Com Ports that have been
  3113.     Opened, the USECOM program's Status Screen also provides information about
  3114.     each of the resident character buffers, if any, that may exist in memory,
  3115.     even those that are currently unused.
  3116.  
  3117.     Largely because of this dual purpose, and because the number of resident
  3118.     character buffers may, in fact, exceed the number of Opened Com Ports,
  3119.     the USECOM program's Status screen, unlike the SHARECOM program's Status
  3120.     screen, is not specific to each of the four Com Ports on a single machine;
  3121.     instead, it provides information specific to each of the four character
  3122.     buffers which may possibly exist in memory.
  3123.  
  3124.     Although this may sound confusing at first, it is actually quite simple.
  3125.     Each character buffer that exists in memory is assigned a number, from
  3126.     1 to 4 inclusive, which represents its position in memory relative to all
  3127.     the other buffers.  The resident character buffer lowest in memory is
  3128.     therefore known as buffer number 1.
  3129.  
  3130.     Once all resident buffers have been assigned numbers indicative of their
  3131.     position in memory, it then becomes possible to report on their "status",
  3132.     in terms of whether or not they are being used, by which Opened Com Port,
  3133.     etc.
  3134.  
  3135.     In fact, as it turns out, this idea of a resident buffer's "status" can
  3136.     even be extended to those buffers that do not yet exist.  This is done
  3137.     by assigning them some arbitrary buffer number higher than all others
  3138.     which do exist, and listing their status as "NONE".  Since they are
  3139.     always listed last, you will know at a glance how many buffers are
  3140.     available to be allocated.
  3141.  
  3142.     THE COMSHARE SYSTEM                        USING A SHAREABLE COM PORT   54
  3143.  
  3144.  
  3145.  
  3146.     Also, if a particular buffer is being used by an Opened Com Port, then
  3147.     relevant information regarding that Com Port can be displayed right along
  3148.     with the buffer's information, thereby facilitating the dissemination of
  3149.     the necessary Com Port Status information.
  3150.  
  3151.     There is only one command line option available to Ascertain the Status,
  3152.     which is:
  3153.  
  3154.  
  3155.     The "/STATUS" Command Line Option           minimum abbreviation:  "/S"
  3156.     ─────────────────────────────────
  3157.  
  3158.     Specifying this option causes USECOM to display to the console a "Com
  3159.     Port / Buffer Status" screen, once all other command line option requests
  3160.     have been fulfilled.  If no other options are present on the command line,
  3161.     then the USECOM program will simply display to the console the Com Port /
  3162.     Buffer Status screen and exit.
  3163.  
  3164.     The Com Port / Buffer Status screen is basically a chart of sorts, which
  3165.     displays information specific to each of the four possible resident Com
  3166.     Port character buffers that may exist on a single machine.
  3167.  
  3168.     An example Com Port Status screen might look like this, with minor
  3169.     differences in the header for the Registered version(s):
  3170.  
  3171.  
  3172.      ╒═════════════════════════════════════════════════════════════════╕
  3173.      │              │   │              ╒═══╕               (TM)        │
  3174.      │              │   │  ╒══╕  ╒══╕  │      ╒══╕  ╒═╤═╕              │░░
  3175.      │         ═══  │   │  ╘══╕  ╞══╛  │      │  │  │ │ │  ═══         │░░
  3176.      │              ╘═══╛  ╘══╛  ╘══   ╘═══╛  ╘══╛  ┘ ┴ └              │░░
  3177.      ╞═════════════════════════════════════════════════════════════════╡░░
  3178.      │     - Network Telecommunications Resource Sharing Utility -     │░░
  3179.      │ NETBIOS Version 1.00       2-Port License      License # T00000 │░░
  3180.      │ Copyright (c) 1994, David A. Stephenson & NashaKala Corporation │░░
  3181.      │                - All rights reserved worldwide -                │░░
  3182.      ├─────────────────────────────────────────────────────────────────┤░░
  3183.      │ TRYWARE VERSION:  << Network Connection will last 30 minutes >> │░░
  3184.      ╞═════════════════════════════════════════════════════════════════╡░░
  3185.      │               ***** Com Port / Buffer Status *****              │░░
  3186.      ╞════════╤════════╤══════════╤═══════════════════════════╤════════╡░░
  3187.      │  Com   │ Buffer │  Buffer  │                           │  GRAD  │░░
  3188.      │  Port  │ Number │  Status  │  Current Com Port Status  │ number │░░
  3189.      ╞════════╪════════╪══════════╪═══════════════════════════╪════════╡░░
  3190.      │   4    │    1   │ EMBEDDED │         - OPENED -        │   02   │░░
  3191.      │   3    │    2   │  IN USE  │         - OPENED -        │   01   │░░
  3192.      │   -    │    3   │ FREEABLE │             --            │   --   │░░
  3193.      │   -    │    4   │   NONE   │             --            │   --   │░░
  3194.      └─────────────────────────────────────────────────────────────────┘░░
  3195.         ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
  3196.  
  3197.  
  3198.     As can be seen from the above example, if one or more pieces of
  3199.     information about a particular resident buffer or Com Port is unknown
  3200.     or indeterminate, one or more consecutive dashes will appear where the
  3201.     information would have been given.
  3202.  
  3203.     THE COMSHARE SYSTEM                        USING A SHAREABLE COM PORT   55
  3204.  
  3205.  
  3206.  
  3207.     An explanation of each of the column headings follows:
  3208.  
  3209.     "Com Port"  -  is the Com Port number of the Opened Com Port that is
  3210.                    currently using the specified resident buffer.  This
  3211.                    number will only appear if the "Current Com Port Status"
  3212.                    is "- OPENED -".
  3213.  
  3214.     "Buffer Number"  -  is the number, or ordinal, given to a particular
  3215.                         resident buffer indicative of its position in memory.
  3216.                         Buffer number 1 would therefore be lowest in memory,
  3217.                         buffer number 2 the next highest in memory, etc.
  3218.                         Nonexistent buffers are assigned the highest buffer
  3219.                         numbers.  All buffers are listed in ascending buffer
  3220.                         number order.
  3221.  
  3222.     "Buffer Status"  -  is the current status of the resident buffer:
  3223.  
  3224.                         "FREEABLE" means that this resident buffer is
  3225.                         currently unused by an Opened Com Port, and can be
  3226.                         released by invoking the USECOM program with the
  3227.                         "/RELEASE" command line option, which implies that
  3228.                         it is not "trapped" under any other block or blocks
  3229.                         of resident memory, other than other "FREEABLE"
  3230.                         buffers.
  3231.  
  3232.                         "IN USE" means that this resident buffer is currently
  3233.                         being used by an Opened Com Port, but that once the
  3234.                         Com Port is Closed, this buffer will be "FREEABLE".
  3235.  
  3236.                         "EMBEDDED" means that this resident buffer is trapped
  3237.                         underneath one or more blocks of resident memory, and
  3238.                         would therefore not be released by invoking the
  3239.                         USECOM program with the "/RELEASE" option.  Buffers
  3240.                         of this type may or may not be currently used by an
  3241.                         Opened Com Port.
  3242.  
  3243.                         "NONE" denotes a resident buffer that does not exist.
  3244.                         Their presence in the list only serves to indicate how
  3245.                         many resident buffers are available to be allocated.
  3246.  
  3247.     "Current Com Port Status"  -  is the current status of the Com Port that
  3248.                                   is using the specified resident buffer.
  3249.  
  3250.                                   There is only one possible status for a
  3251.                                   Com Port that is using a resident buffer,
  3252.                                   which is "- OPENED -", indicating an Open
  3253.                                   Com Port.  If the specified resident buffer
  3254.                                   is not being used, this field is not
  3255.                                   applicable, and a dash will therefore
  3256.                                   appear in its place.
  3257.  
  3258.     "GRAD number"  -  is the GRAD number of the GRAD that the Opened Com Port
  3259.                       using the specified resident buffer is attached to.
  3260.                       This number will only appear if the "Current Com Port
  3261.                       Status" is "- OPENED -".
  3262.  
  3263.     THE COMSHARE SYSTEM                        USING A SHAREABLE COM PORT   56
  3264.  
  3265.  
  3266.  
  3267.     Other Options
  3268.     ─────────────
  3269.  
  3270.     All of the USECOM program's remaining available command line options
  3271.     are concerned with managing either unused resident character buffers, or
  3272.     those parts of resident memory which are not used as character buffers,
  3273.     which primarily refers to that part of resident memory which holds the
  3274.     actual machine instructions, known as "code", required to communicate
  3275.     with GRADs connected to across the network.
  3276.  
  3277.     There are four remaining command line options available to use with the
  3278.     USECOM program, two of which are concerned with managing unused resident
  3279.     character buffers.
  3280.  
  3281.  
  3282.     The "/LOAD" Command Line Option             minimum abbreviation:  "/L"
  3283.     ───────────────────────────────
  3284.  
  3285.     Specifying this option causes USECOM to load into resident memory the
  3286.     program code needed to communicate with GRADs connected to across the
  3287.     network, but not to Open or Close any Com Ports.  All subsequent requests
  3288.     to Open a Com Port will therefore only require another 2-3K of resident
  3289.     memory each, providing the "/SHUTDOWN" option has not been used in the
  3290.     interim.
  3291.  
  3292.     This option does not take a parameter value.
  3293.  
  3294.     If this option is specified and the USECOM program's resident code is
  3295.     already resident in memory, from either a previous "/OPEN", "/LOAD" or
  3296.     "/BUFFER" command, then USECOM will generate an appropriate error message
  3297.     and exit, unless other options exist on the command line which render it
  3298.     superfluous, such as "/OPEN", "/CLOSE", or "/BUFFER", in which case it
  3299.     will simply be ignored.
  3300.  
  3301.     One of the possible uses of this command line option might be to load
  3302.     USECOM's program code into DOS's HIGH memory area through the use of the
  3303.     DOS "LoadHigh" command in order to save conventional memory, which could
  3304.     even be done from within your AUTOEXEC.BAT file, assuming that the
  3305.     network software was installed by then.
  3306.  
  3307.  
  3308.     The "/BUFFER" Command Line Option           minimum abbreviation:  "/B"
  3309.     ─────────────────────────────────
  3310.  
  3311.     Specifying this option causes USECOM to create a single unused character
  3312.     buffer in resident memory.  It does not take a parameter value.
  3313.  
  3314.     Its primary use is for creating a resident character buffer that will be
  3315.     used when Opening a Com Port under Windows 3.1, the exact procedure for
  3316.     which is explained in APPENDIX B.
  3317.  
  3318.     The use of this option implies the "/LOAD" option, which means that if
  3319.     the USECOM program's resident program code does not already exist in
  3320.     memory, then it will be loaded into memory before the buffer is created.
  3321.  
  3322.     THE COMSHARE SYSTEM                        USING A SHAREABLE COM PORT   57
  3323.  
  3324.  
  3325.  
  3326.     This command line option will be ignored if accompanied by either an
  3327.     "/OPEN" or "/CLOSE" command line option.
  3328.  
  3329.     No more than four character buffers are allowed to exist in resident
  3330.     memory at a time, so if four resident character buffers already exist
  3331.     when this option is used, the USECOM program will issue an appropriate
  3332.     error message and abort.
  3333.  
  3334.  
  3335.     The "/RELEASE" Command Line Option          minimum abbreviation:  "/R"
  3336.     ──────────────────────────────────
  3337.  
  3338.     Specifying this option causes USECOM to release all 'freeable' buffers
  3339.     that exist in resident memory.  A 'freeable' buffer is any unused
  3340.     resident character buffer that is not "trapped" under any other block
  3341.     or blocks of resident memory, other than other 'freeable' buffers.
  3342.  
  3343.     The primary use of this option is to free up the conventional memory
  3344.     taken up by an Opened Com Port's character buffer, after it has been
  3345.     Closed.
  3346.  
  3347.     This option does not take a parameter value.
  3348.  
  3349.  
  3350.     The "/SHUTDOWN" Command Line Option         minimum abbreviation:  "/SH"
  3351.     ───────────────────────────────────
  3352.  
  3353.     Specifying this option causes USECOM to effectively disable all of
  3354.     USECOM's resident functionality by Closing all Open Com Ports, and
  3355.     releasing all resident memory taken up by previous invocations of the
  3356.     USECOM program, which includes all resident code and buffers.
  3357.  
  3358.     If some or all of the resident memory taken up by the USECOM program
  3359.     cannot be released after the USECOM program has Closed all Open Com Ports
  3360.     and released as much resident memory as it could, it will exit with an
  3361.     appropriate error message, at which point the USECOM program can be, and
  3362.     probably should be, invoked again to Ascertain the Status, which will
  3363.     indicate what resident memory remains, and why.
  3364.  
  3365.     This option does not take a parameter value.
  3366.  
  3367.     THE COMSHARE SYSTEM                               THE PICKCOM PROGRAM   58
  3368.  
  3369.  
  3370.  
  3371.     THE PICKCOM PROGRAM
  3372.     ══════════════════════════════════════════════════════════════════════════
  3373.  
  3374.  
  3375.     This section of the documentation assumes that you have read at least the
  3376.     "Theory & Nomenclature" sub-section of the "GETTING STARTED" section of
  3377.     this documentation, as most of the key terms used here are defined there.
  3378.  
  3379.  
  3380.     What The PICKCOM Program Does
  3381.     ─────────────────────────────
  3382.  
  3383.     Essentially, the PICKCOM program does exactly what the USECOM program
  3384.     does.  In particular, it is used to:
  3385.  
  3386.     1) connect a local Com Port to an available GRAD on the network, which
  3387.        is called "Opening a Com Port", or
  3388.  
  3389.     2) disconnect an already Opened Com Port from the GRAD it is attached
  3390.        to, which is called "Closing a Com Port".
  3391.  
  3392.     The difference between the two programs is that the PICKCOM program is
  3393.     completely menu-driven, whereas the USECOM program is command-line driven.
  3394.  
  3395.     What this means is that, unlike the USECOM program, the PICKCOM program
  3396.     does not require you to explicitly specify the parameters of a particular
  3397.     task on its command line; instead, it allows you to choose them from a
  3398.     series of full-color menus which it supplies.
  3399.  
  3400.     The PICKCOM program is therefore easier to use for most people, especially
  3401.     for selecting a specific GRAD on the network to connect to.
  3402.  
  3403.  
  3404.     Starting The PICKCOM Program
  3405.     ────────────────────────────
  3406.  
  3407.     The PICKCOM program is invoked by typing in "PICKCOM /n" at the DOS
  3408.     command prompt, where "n" is the maximum number of Com Ports allowed for
  3409.     by the ComShare System License currently in use.  If running a 5-Port
  3410.     version of the ComShare System for example, the PICKCOM program would be
  3411.     invoked as "PICKCOM /5".  For the Tryware version of the ComShare System,
  3412.     since it is a 2-Port License, the PICKCOM program would be invoked as
  3413.     "PICKCOM /2".
  3414.  
  3415.     This "/n" parameter tells the PICKCOM program to stop searching the
  3416.     network for any more available GRADs once it has investigated the status
  3417.     of the first "n" GRAD numbers.  If not specified, the PICKCOM program will
  3418.     search the entire network for 99 possibly existent GRADs (the default)
  3419.     before invoking its menu system, and since it can take the PICKCOM program
  3420.     up to a full second to determine the status of each possibly existent
  3421.     GRAD, considerable time could be wasted if the "/n" parameter is not
  3422.     specified.  The Ctrl-Break key combination can also be used to curtail
  3423.     the search however, once the PICKCOM program has started.
  3424.  
  3425.     THE COMSHARE SYSTEM                               THE PICKCOM PROGRAM   59
  3426.  
  3427.  
  3428.  
  3429.     Additionally, a "password" can be specified on the PICKCOM program's
  3430.     command line which, if present, will cause the PICKCOM program to ignore
  3431.     the existence of all password-protected GRADs found whose passwords do not
  3432.     exactly match.  In other words, only those GRADs with a matching password
  3433.     or no password will be deemed existent.  It will also cause the PICKCOM
  3434.     program to suppress prompting for a password in the menu system when
  3435.     Opening a Com Port (more on that later).
  3436.  
  3437.     Specifying a password on the command line can therefore be used to limit
  3438.     the number of available GRADs that will be shown in the menu system to
  3439.     only those with either a certain password, or no password at all.
  3440.  
  3441.     The password specified on the command line is case sensitive, and is
  3442.     not preceded by any special characters on the command line.  It can be
  3443.     enclosed in quotation marks, which will not be considered as part of the
  3444.     password, and MUST be enclosed in quotation marks if the password contains
  3445.     any spaces or tabs.  If it is desired that the password contain quotation
  3446.     marks, each must be preceded by a '\' character, which will not be
  3447.     considered as part of the password.
  3448.  
  3449.     Any number of characters may be specified for the password, but only the
  3450.     first 20 will be significant; the remainder will be discarded (a '\"'
  3451.     combination is considered one character).
  3452.  
  3453.     Also, if you are using a color card with either a Black & White or "Grey
  3454.     Scale" monitor, such as those found in monochrome laptops for instance,
  3455.     a single "/M" should be added to the PICKCOM program's command line
  3456.     (preceded by at least one space, of course), otherwise some of the color
  3457.     screens may be unreadable.
  3458.  
  3459.     All of the above command line parameters are optional, and may appear in
  3460.     any order, but only one instance of each is allowed.  A second instance
  3461.     of any of them will always be interpreted as a password, and two or more
  3462.     passwords appearing on the command line will invoke the help screen.
  3463.  
  3464.     Lastly, a brief but succinct explanation of all of the above command line
  3465.     parameters can be obtained by invoking the PICKCOM program with "PICKCOM
  3466.     help screen".
  3467.  
  3468.  
  3469.     How The PICKCOM Program Works
  3470.     ─────────────────────────────
  3471.  
  3472.     Once invoked, the first task that the PICKCOM program attempts to perform
  3473.     is to check the availability of all GRADs that could possibly exist on the
  3474.     network, which it does sequentially by checking the current status of each
  3475.     individual GRAD number, starting with GRAD number 1, and proceeding
  3476.     through to either GRAD number 99, the default, or the highest allowable
  3477.     GRAD number that was specified on the command line (see above).
  3478.  
  3479.     As the status of each GRAD is investigated, a one-line status message is
  3480.     displayed to the console which details its GRAD number, until all GRADs
  3481.     have been checked, at which point the menu system is invoked.  Anytime
  3482.     before that however, the Ctrl-Break key combination can be used to cancel
  3483.     any further GRAD number investigations and force the invocation of the
  3484.     menu system.  If this is done however, the PICKCOM program will assume
  3485.  
  3486.     THE COMSHARE SYSTEM                               THE PICKCOM PROGRAM   60
  3487.  
  3488.  
  3489.  
  3490.     that all remaining unverified GRAD numbers do not exist.
  3491.  
  3492.     Upon invocation of the menu system, the PICKCOM program works very much
  3493.     like the ComShare System's INSTALL.EXE program, in that it then becomes
  3494.     fully "menu-driven".  For an explanation of that term and further details
  3495.     pertaining to the specific interactive properties of the menuing system
  3496.     implementation common to both programs, the sub-sections entitled, "How
  3497.     The INSTALL Program Works" and "The INSTALL Program's Menus" in the
  3498.     section of this documentation entitled "THE INSTALL PROGRAM" should be
  3499.     consulted, as the information contained there applies equally well to
  3500.     the PICKCOM program's interactive operation, and therefore need not be
  3501.     repeated here.
  3502.  
  3503.     As mentioned previously, the PICKCOM program's main purpose is to enable
  3504.     either the Opening or Closing of Com Ports in as user-friendly a manner
  3505.     as possible.  The PICKCOM program however, doesn't actually perform either
  3506.     task.  Instead, at the end of its processing, the PICKCOM program will
  3507.     invoke the USECOM program with appropriate command line parameters to do
  3508.     the actual work of making or breaking a Com Port connection across the
  3509.     network.
  3510.  
  3511.     For this reason, the USECOM.COM program must exist in either the current
  3512.     directory, or a directory that exists in the DOS "PATH" environment
  3513.     variable, before the PICKCOM program can successfully carry out the tasks
  3514.     it is asked to perform.
  3515.  
  3516.  
  3517.     The PICKCOM Program's Main Menu
  3518.     ───────────────────────────────
  3519.  
  3520.     Once the PICKCOM program's initial GRAD search has been concluded, as
  3521.     explained above, it will display to the console its "Primary Window",
  3522.     which is a full-screen window containing, from the top:
  3523.  
  3524.     1)  an Identification Header, a boxed area at the very top of the Primary
  3525.         Window, which contains the program name and copyright information,
  3526.  
  3527.     2)  the "Main Menu", the one-line, top-level menu for the program,
  3528.  
  3529.     3)  the "menu description window", a one-line window for displaying a
  3530.         description of the "current" menu item,
  3531.  
  3532.     4)  a rather generous, pattern-filled work area where all subsequent
  3533.         menus will appear and,
  3534.  
  3535.     5)  right at the bottom, a one-line "invocation window" for displaying
  3536.         the USECOM invocation that will be used to carry out the current task.
  3537.  
  3538.  
  3539.     The Primary Window, with all of the aforementioned component parts, will
  3540.     look something like this:
  3541.  
  3542.     THE COMSHARE SYSTEM                               THE PICKCOM PROGRAM   61
  3543.  
  3544.  
  3545.  
  3546. ▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄
  3547. ▌      * * *  P I C K C O M --- The ComShare System's Menu Facility  * * *     ▐
  3548. ▌        Copyright (c) 1994, David A. Stephenson & NashaKala Corporation       ▐
  3549. ▌                       - All rights reserved worldwide -                      ▐
  3550. ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
  3551. │              Open a Port                           Close a Port              │
  3552. ├──────────────────────────────────────────────────────────────────────────────┤
  3553. │                  Attach a specified GRAD to a local Com Port                 │
  3554. ├──────────────────────────────────────────────────────────────────────────────┤
  3555. │°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙│
  3556. │°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙│
  3557. │°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙│
  3558. │°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙│
  3559. │°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙│
  3560. │°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙│
  3561. │°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙│
  3562. │°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙│
  3563. │°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙│
  3564. │°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙│
  3565. │°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙│
  3566. │°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙│
  3567. │°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙│
  3568. │°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙│
  3569. │°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙°∙│
  3570. └██████████████████████████████████████████████████████████████████████████████┘
  3571.  
  3572.  
  3573.     The selection bar of the Main Menu, which cannot be shown in the above,
  3574.     will be on the "Open a Port" menu item, and the menu description window
  3575.     will therefore be displaying a brief description of what that means, in
  3576.     this case telling you that it means to "Attach a specified GRAD to a
  3577.     local Com Port".
  3578.  
  3579.     If you would like to Open a Com Port, ie: attach a local Com Port to an
  3580.     available GRAD across the network, you should choose the "Open a Port"
  3581.     menu item from the Main Menu.  Further information on that choice is
  3582.     provided in the following sub-section entitled, "Opening A Com Port With
  3583.     PICKCOM".
  3584.  
  3585.     If you would like to Close a Com Port, ie: detach a local Com Port from
  3586.     the GRAD it is currently attached to, you should choose the "Close a Port"
  3587.     menu item from the Main Menu.  Further information on that choice is
  3588.     provided in the following sub-section entitled, "Closing A Com Port With
  3589.     PICKCOM".
  3590.  
  3591.  
  3592.     Opening A Com Port With PICKCOM
  3593.     ───────────────────────────────
  3594.  
  3595.     By selecting the "Open a Port" menu item from the PICKCOM program's Main
  3596.     Menu, you will be initiating the process of attaching a local Com Port to
  3597.     a specifically chosen available GRAD existing somewhere on the network.
  3598.  
  3599.     Upon selection of the "Open a Port" menu item, a new menu window will pop
  3600.     up in the work area, each menu item of which will specify both the GRAD
  3601.     number and description string, if one was specified, of a GRAD existing
  3602.  
  3603.     THE COMSHARE SYSTEM                               THE PICKCOM PROGRAM   62
  3604.  
  3605.  
  3606.  
  3607.     on the network which is currently available to connect to.
  3608.  
  3609.     For an explanation of what a "description string" is, please refer to the
  3610.     sub-section entitled, 'The "/TEXT" Command Line Option' in the "MAKING A
  3611.     COM PORT SHAREABLE" section of this documentation.
  3612.  
  3613.     The list of available GRADs will always be in GRAD number order, and the
  3614.     selection bar will initially be on the item at the top of the list.
  3615.  
  3616.     Each GRAD in the list is a separate menu item, and can therefore be
  3617.     selected in the usual way.  The GRAD selected will be the GRAD that is
  3618.     connected to.  Pressing the ESCAPE key will abort the GRAD selection
  3619.     process and return to the Main Menu.
  3620.  
  3621.     If there are more than 12 concurrently available GRADs on the network
  3622.     however, the pop-up menu of available GRADs will be made "scrollable",
  3623.     which means that the following extra keyboard functionality will be added
  3624.     to facilitate the display and/or access of the additional available GRADs:
  3625.  
  3626.     PgDn  -  will scroll up into the window the next 12 available GRADs.
  3627.     ~~~~
  3628.              If there are less than 12 additional GRADs left to display,
  3629.              scrolling will proceed past the last available GRAD number
  3630.              to the first available GRAD number, and continue in ascending
  3631.              GRAD number order until a total of 12 GRAD number items have
  3632.              been scrolled up into the window.  In other words, the list
  3633.              of GRADs will 'wrap'.
  3634.  
  3635.              The selection bar will maintain its relative position within
  3636.              the window.
  3637.  
  3638.     PgUp  -  will scroll down into the window the previous 12 available GRADs.
  3639.     ~~~~
  3640.              If there are less than 12 previous GRADs left to display,
  3641.              scrolling will proceed past the first available GRAD number
  3642.              to the last available GRAD number, and continue in descending
  3643.              GRAD number order until a total of 12 GRAD number items have
  3644.              been scrolled down into the window.  In other words, the list
  3645.              of GRADs will 'wrap'.
  3646.  
  3647.              The selection bar will maintain its relative position within
  3648.              the window.
  3649.  
  3650.     DownArrow  -  moves the selection bar one item downwards, unless the
  3651.     ~~~~~~~~~     selection bar is on the last item in the window, in which
  3652.                   case the next available GRAD number item will be scrolled
  3653.                   up into the window, and the selection bar moved to it.
  3654.  
  3655.     UpArrow    -  moves the selection bar one item upwards, unless the
  3656.     ~~~~~~~       selection bar is on the first item in the window, in which
  3657.                   case the previous available GRAD number item will be
  3658.                   scrolled down into the window, and the selection bar moved
  3659.                   to it.
  3660.  
  3661.     All other keys work as they normally would for any other menu.
  3662.  
  3663.     THE COMSHARE SYSTEM                               THE PICKCOM PROGRAM   63
  3664.  
  3665.  
  3666.  
  3667.     Once a GRAD has been chosen to connect to, a new menu window pops up, the
  3668.     menu items of which are the Com Ports available to make the connection
  3669.     with.  Only those Com Ports which are not already connected to a GRAD
  3670.     will be listed.
  3671.  
  3672.     A Com Port should be chosen at this point which does not have anything
  3673.     connected to it, such as a modem or a mouse.  The choice of Com Port made
  3674.     here will be the Com Port that your telecommunications application will
  3675.     use to communicate with the GRAD (see the "How The ComShare System Works"
  3676.     sub-section in the "INTRODUCTION" section of this documentation for
  3677.     further information).
  3678.  
  3679.     Once a suitable Com Port has been chosen, the PICKCOM program then checks
  3680.     to see if the GRAD chosen earlier requires a password.  If it does, a new
  3681.     window will pop up in the work area prompting you to enter a password.
  3682.  
  3683.     If the PICKCOM program was invoked with a password on its command line
  3684.     however, the password prompt will *not* appear, regardless of whether or
  3685.     not the chosen GRAD requires a password.  See the "Starting The PICKCOM
  3686.     Program" sub-section, above, for further information on the password
  3687.     command line option.
  3688.  
  3689.     If the password prompt does appear, simply pressing the ENTER key before
  3690.     typing in any other characters will be taken as meaning that no password
  3691.     be given for the GRAD being connected to.  Alternatively, a password can
  3692.     be typed in, which will be used as the password for the GRAD when the
  3693.     connection attempt is made.
  3694.  
  3695.     When entering a password, the following points should be kept in mind:
  3696.  
  3697.     1)  For obvious security reasons, the characters typed when entering a
  3698.         password will not be echoed to the screen.  The cursor position will
  3699.         be updated as characters are typed however, and all editing keys
  3700.         (such as Backspace) still work as expected.
  3701.  
  3702.     2)  Unlike a password entered on the command line, the password should
  3703.         *not* be enclosed in quotation marks.  Also, if the password contains
  3704.         any quotation marks, they should simply be entered as such, *without*
  3705.         the preceding '\' character required by command line passwords.
  3706.  
  3707.     3)  After 20 characters have been typed in for the password, any further
  3708.         characters typed will *replace* the 20th character.
  3709.  
  3710.     Once all the characters of the password have been typed in, pressing the
  3711.     ENTER key will submit the password.  Pressing the ESCAPE key at any time
  3712.     before that will abort the password entry procedure, and processing will
  3713.     continue with the previous menu.
  3714.  
  3715.     Once the password has been submitted, the window containing the (hidden?)
  3716.     password will disappear, and the USECOM command line displayed in the
  3717.     invocation window will be updated to include a "/pass" command line
  3718.     option, the associated parameter value for which will be a quoted string
  3719.     of lower case x's, whose length will be equal to the length of the
  3720.     password just input plus the number of quotation marks contained in it.
  3721.  
  3722.     THE COMSHARE SYSTEM                               THE PICKCOM PROGRAM   64
  3723.  
  3724.  
  3725.  
  3726.     The x's appear instead of the password in the invocation window as a
  3727.     security precaution, and will be replaced by the password when the
  3728.     USECOM program is invoked.
  3729.  
  3730.     A confirmation window then appears in the work area, the text of which
  3731.     will be the question, "Are You Sure?" for which a menu is displayed
  3732.     allowing for either a "Yes" or "No" response.  Pressing the ESCAPE key
  3733.     will be considered a "No" response.
  3734.  
  3735.     At this point, the PICKCOM program is ready to carry out the Open request
  3736.     by invoking the USECOM program with the parameters shown in its invocation
  3737.     window.
  3738.  
  3739.     Choosing the "Yes" menu item from the confirmation window will therefore
  3740.     cause the PICKCOM program to end its processing and invoke the USECOM
  3741.     program.  At the conclusion of the USECOM program's processing of the
  3742.     request, control will then be returned to DOS.
  3743.  
  3744.     Choosing the "No" menu item on the other hand (or pressing the ESCAPE key)
  3745.     will close the confirmation window, and processing will continue with the
  3746.     previously processed Com Port selection menu, from which you can either
  3747.     correct the Com Port selection and continue from there, or use the ESCAPE
  3748.     key to step back through the previous menus.
  3749.  
  3750.  
  3751.     Closing A Com Port With PICKCOM
  3752.     ───────────────────────────────
  3753.  
  3754.     By selecting the "Close a Port" menu item from the PICKCOM program's Main
  3755.     Menu, you will be initiating the process of detaching a local Com Port
  3756.     from the GRAD it is currently attached to.
  3757.  
  3758.     Upon selection of the "Close a Port" menu item, a new menu window will
  3759.     pop up in the work area, each menu item of which will represent an
  3760.     existing connection between a local Com Port and a remote GRAD; these
  3761.     are the currently attached Com Ports which can be detached.
  3762.  
  3763.     Selecting any of the items from this menu will therefore be interpreted
  3764.     as a request to break the connection indicated, thereby "Closing the
  3765.     Com Port".
  3766.  
  3767.     Once a desired connection is chosen, a confirmation window will pop up in
  3768.     the work area, the function and operation of which is exactly the same as
  3769.     that described in the previous section for "Opening a Port", and serves to
  3770.     finalize the request.
  3771.  
  3772.     Closing a Com Port is therefore quite a simple procedure in the PICKCOM
  3773.     program.
  3774.  
  3775.     THE COMSHARE SYSTEM                                      REGISTRATION   65
  3776.  
  3777.  
  3778.  
  3779.     REGISTRATION
  3780.     ══════════════════════════════════════════════════════════════════════════
  3781.  
  3782.  
  3783.     The term "Registration" used throughout this and other documentation
  3784.     within the ComShare System refers to the process of purchasing a License
  3785.     to use any one of the six different "Registered" versions of the ComShare
  3786.     System, each of which are exactly like the Tryware version, except that:
  3787.  
  3788.     1)  there is no built-in time limit to the network connection between
  3789.         the resident SHARECOM and USECOM programs, as there is in the
  3790.         Tryware version, and
  3791.  
  3792.     2)  more Com Ports may be made concurrently shareable on a single
  3793.         network, depending on the License purchased.
  3794.  
  3795.     Also, the Registered version of the ComShare System only consists of
  3796.     the two programs, "SHARECOM.COM" and "USECOM.COM".  The "PICKCOM.EXE"
  3797.     program, since it will work with any network-compatible version of the
  3798.     ComShare System, is not considered part of any Registered version.
  3799.  
  3800.     Each of the six different Registered versions of the ComShare System has
  3801.     a separate License agreement, the sole differentiating element among
  3802.     them being how many concurrently shareable Com Ports, or GRADs, each one
  3803.     allows for, and the name given to each separate License reflects that
  3804.     fact.  A "10-Port" License, for example, is a License which grants the
  3805.     right to make concurrently shareable on a single network up to 10 Com
  3806.     Ports.
  3807.  
  3808.     The six different Registered Licenses available to purchase, and their
  3809.     respective purchase prices, are:
  3810.  
  3811.           License Name           Price        Price per Com Port
  3812.           ~~~~~~~~~~~~           ~~~~~        ~~~~~~~~~~~~~~~~~~
  3813.  
  3814.     the  "2-Port"   License :    US $25     ( $12.50 per Com Port )
  3815.     the  "5-Port"   License :    US $40     (  $8.00 per Com Port )
  3816.     the  "10-Port"  License :    US $60     (  $6.00 per Com Port )
  3817.     the  "20-Port"  License :    US $100    (  $5.00 per Com Port )
  3818.     the  "50-Port"  License :    US $200    (  $4.00 per Com Port )
  3819.     the  "99-Port"  License :    US $300    (  $3.03 per Com Port )
  3820.  
  3821.     Before purchasing any of the above Licenses however, it's important to
  3822.     realize that they are, in fact, License agreements, which means that they
  3823.     will precisely define your rights to use, and your obligations in owning,
  3824.     the products to which they pertain.  The terms and conditions of each
  3825.     therefore, must be agreed to in their entirety before the product can be
  3826.     used.
  3827.  
  3828.     It therefore becomes important to know beforehand what you will be
  3829.     expected to agree to, before you buy any of the above Licenses, to ensure
  3830.     that any purchase decision you may make in regard to them is an informed
  3831.     one.
  3832.  
  3833.     THE COMSHARE SYSTEM                                      REGISTRATION   66
  3834.  
  3835.  
  3836.  
  3837.     Towards that end, the next sub-section details all of the terms and
  3838.     conditions that are common to each of the six different Registered
  3839.     Licenses available to purchase.  If, for one reason or another, you
  3840.     cannot agree to one or more of these terms and conditions, you are
  3841.     encouraged not to buy a Registered License.
  3842.  
  3843.  
  3844.     The Registered Licenses
  3845.     ───────────────────────
  3846.  
  3847.     As mentioned previously, the following terms and conditions are common
  3848.     to each of the six different Registered Licenses available to purchase.
  3849.  
  3850.     They should all be agreeable to you before purchasing any of the
  3851.     Registered Licenses of the ComShare System.
  3852.  
  3853.     Upon receipt of your Registered License, you will be granted the
  3854.     following rights:
  3855.  
  3856.     1)  The right to use your Licensed copies of the Registered version of
  3857.         the ComShare System on one (1) interconnected Local Area Network at
  3858.         a time, for any purpose for as long as you want, provided:
  3859.  
  3860.         A)  you do not attempt, either directly or indirectly, to disassemble
  3861.             or otherwise reverse engineer any of its executables, and
  3862.  
  3863.         B)  you do not attempt, encourage, or allow, either directly or
  3864.             indirectly, the distribution or dissemination of any or all of
  3865.             its parts to any machine that is not connected to the Local Area
  3866.             Network on which it is being used, and
  3867.  
  3868.         C)  you do not use it to make more Com Ports concurrently shareable
  3869.             on the Local Area Network than are specified by the License
  3870.             ( *this will be License-specific* ).
  3871.  
  3872.     2)  The right to copy your Registered version of the ComShare System onto
  3873.         any machine connected to the single Local Area Network on which it is
  3874.         being used as defined in paragraph 1 above, and
  3875.  
  3876.     3)  The right to make a single backup copy of your Registered version of
  3877.         the ComShare System for archival purposes only.
  3878.  
  3879.  
  3880.     In addition, by purchasing a License to use a Registered version of the
  3881.     ComShare System, you:
  3882.  
  3883.     1)  are obligated BY LAW to ensure, through all reasonable measures, the
  3884.         absolute non-distribution, without exception, of any or all of the
  3885.         information contained in the "Registration Confirmation Letter" which
  3886.         is necessary to create your Licensed copies of the Registered version,
  3887.  
  3888.     2)  are obligated BY LAW to ensure, through all reasonable measures, that
  3889.         no part or parts of your Licensed copies of the Registered version of
  3890.         the ComShare System exists and/or will exist on any machine that is
  3891.         not connected to the Local Area Network on which it is being used, and
  3892.  
  3893.     THE COMSHARE SYSTEM                                      REGISTRATION   67
  3894.  
  3895.  
  3896.  
  3897.     3)  agree to hold harmless both NashaKala Corporation and David A.
  3898.         Stephenson from and against any claim of any damage or loss, either
  3899.         direct or consequential, which may result from the use or misuse of
  3900.         any part or parts of your Licensed copies of the Registered version
  3901.         of the ComShare System.
  3902.  
  3903.  
  3904.     Ordering A Registered License
  3905.     ─────────────────────────────
  3906.  
  3907.     Having gotten through all of the above legal stuff, you might be
  3908.     relieved to know that ordering a Registered License is a relatively
  3909.     easy procedure.
  3910.  
  3911.     The first step in ordering a Registered License is to fill out the
  3912.     ComShare System Order Form, which is quite easily accomplished by
  3913.     invoking the ComShare System Install program, and choosing the "Register
  3914.     ComShare" menu item from the main menu.  This will guide you through the
  3915.     steps required to print to your printer either a blank Order Form, which
  3916.     you can then fill out by hand, or an Order Form that has been completed
  3917.     online.
  3918.  
  3919.     The completed Order Form is then mailed to NashaKala Corporation, whose
  3920.     mailing address appears in the Order Form itself, along with a cheque or
  3921.     money order made out to "NashaKala Corporation" in US funds, for the
  3922.     total amount indicated in the Order Form.
  3923.  
  3924.     Once the Order Form and the payment have been received, NashaKala Corp.
  3925.     will then send you a "Registration Confirmation Letter", which will
  3926.     contain both your License, and a set of very simple instructions on how
  3927.     to create your Licensed copies of the Registered version of the ComShare
  3928.     System using the very same Install program you used to create the
  3929.     Tryware version.
  3930.  
  3931.     And that's it!  As a footnote to the above procedure however, it should
  3932.     be mentioned that deleting the Install program anytime before receiving
  3933.     the Registration Confirmation Letter is definitely not a good idea, as
  3934.     it will be instrumental in creating the Registered version.  In fact,
  3935.     retaining the entire ComShare System distribution .ZIP file is an even
  3936.     better idea, as it can exist as an important backup for those parts of
  3937.     the ComShare System that are common to both the Registered and Tryware
  3938.     versions, such as the PICKCOM program, and this documentation.  You
  3939.     might even want to use it to lower your download/upload ratio on some
  3940.     BBS's ( 'subtle' hint there... ).
  3941.  
  3942.  
  3943.     NashaKala Corporation's Upgrade Policy
  3944.     ──────────────────────────────────────
  3945.  
  3946.     Once you have purchased and used a particular Registered License of the
  3947.     ComShare System, you may find that the number of concurrently shareable
  3948.     Com Ports (GRADs) allowed for by your current License is insufficient
  3949.     at times to handle the concurrent demand for their use, especially if
  3950.     that demand grows with time.
  3951.  
  3952.     THE COMSHARE SYSTEM                                      REGISTRATION   68
  3953.  
  3954.  
  3955.  
  3956.     If this should happen, you will need to upgrade your License to one
  3957.     which allows for a larger number of concurrent GRADs.  And yes, you
  3958.     will also have to buy more modems (if that is what you're sharing).
  3959.  
  3960.     Fortunately, you will not have to pay any more to upgrade your current
  3961.     License to a higher-numbered Port License than you would have had to
  3962.     pay for that License in the first place.  This is because any money you
  3963.     have already paid to NashaKala Corporation for any lesser-numbered Port
  3964.     License(s) of the ComShare System can be DEDUCTED from the purchase price
  3965.     of any higher-numbered Port License.
  3966.  
  3967.     Say, for example, that you initially purchased a 10-Port Registered
  3968.     License of the ComShare System, but six months later you add 50 more
  3969.     nodes to your network.  Suddenly you are deluged with complaints from
  3970.     your Users that they can never find an available GRAD on the network
  3971.     because they're always in use ("In Session").
  3972.  
  3973.     At this point, you would order the 20-Port Registered License of the
  3974.     ComShare System (and 10 more phone lines - the *real* expense), but you
  3975.     would only have to pay the *difference* in price between the 10-Port
  3976.     License you already have, and the 20-Port License you wish to procure,
  3977.     which would amount to a paltry 40 dollars ( $100 - $60 = $40 ).
  3978.  
  3979.     If you then added another 50 Users and the same thing happened, you
  3980.     might want to buy 10 more modems and order the 50-Port Registered
  3981.     License, for which you would then pay $100 ( $200 - $100 = $100 ).
  3982.  
  3983.     The procedure to order an upgraded License is the same as that required
  3984.     to order an initial License, except that in the Order Form you will be
  3985.     required to specify the dollar amount that you are deducting, and your
  3986.     current License number.  If you are filling out the Order Form online
  3987.     from within the ComShare System Install program, you should choose the
  3988.     "No" menu item in response to the question, "Is this your first time
  3989.     ordering the ComShare System ?", which will invoke the necessary steps.
  3990.  
  3991.     THE COMSHARE SYSTEM                                     APPENDIX  -A-   69
  3992.  
  3993.  
  3994.  
  3995.     APPENDIX A: USING THE COMSHARE SYSTEM WITH TELEMATE
  3996.     ══════════════════════════════════════════════════════════════════════════
  3997.  
  3998.  
  3999.     As mentioned previously, if you plan to use the ComShare System with the
  4000.     TeleMate program, you are STRONGLY advised to read this Appendix, in its
  4001.     entirety, before attempting to use the two programs together.
  4002.  
  4003.     At the time of this writing, TeleMate version 4.12 is available for
  4004.     downloading on virtually any good BBS, and probably other sources,
  4005.     as the following four files:
  4006.  
  4007.     TM412-1.ZIP     TeleMate Comm program ver 4.12 - part 1 of 4
  4008.     TM412-2.ZIP     TeleMate Comm program ver 4.12 - part 2 of 4
  4009.     TM412-3.ZIP     TeleMate Comm program ver 4.12 - part 3 of 4
  4010.     TM412-4.ZIP     TeleMate Comm program ver 4.12 - part 4 of 4
  4011.  
  4012.  
  4013.     Setting Up TeleMate To Use a GRAD
  4014.     ─────────────────────────────────
  4015.  
  4016.     To set up the TeleMate program to use a GRAD instead of an ordinary
  4017.     modem, the following steps are required in the order indicated:
  4018.  
  4019.     1)  If you already have the TeleMate program installed, skip to step 3.
  4020.  
  4021.     2)  Once you have obtained the TeleMate program, unzip all the files
  4022.         into a single directory, change to that directory, then print out
  4023.         and/or read as much as you can of the file "TELEMATE.DOC", and any
  4024.         other peripheral documentation, especially the section or sections
  4025.         pertaining to "THE INSTALLATION PROGRAM".
  4026.  
  4027.     3)  While still in the TeleMate directory, type in "TMINST" at the DOS
  4028.         prompt.  This will run the TeleMate Install program.
  4029.  
  4030.     4)  Choose the "Com Parameter" menu item, which will bring up the "Com
  4031.         Para" sub-menu.  Choose each of the following items from that menu
  4032.         in turn, and change their settings as indicated:
  4033.  
  4034.         the "Com Port" setting
  4035.         ~~~~~~~~~~~~~~~~~~~~~~
  4036.         Choose any number between 1 and 4.  Do NOT choose a number higher
  4037.         than 4, because the USECOM program does not recognize them.  The
  4038.         number you choose here is completely arbitrary, but must be the
  4039.         same as the Com Port number you will be "Opening" with the USECOM
  4040.         program prior to using the TeleMate program.  Do not choose a Com
  4041.         Port that has anything attached to it, such as a modem or a mouse.
  4042.         In other words, choose an 'unused' Com Port.
  4043.  
  4044.         the "Baud Rate" setting
  4045.         ~~~~~~~~~~~~~~~~~~~~~~~
  4046.         Choose a baud rate LESS THAN OR EQUAL TO 9600.  If the GRAD you plan
  4047.         to attach to can handle higher baud rates than that, don't worry;
  4048.         practically all higher speed modems can recognize the higher speeds
  4049.         on connection and compensate accordingly.  The reason for restricting
  4050.         the baud rate here is because the TeleMate program will not allow a
  4051.  
  4052.     THE COMSHARE SYSTEM                                     APPENDIX  -A-   70
  4053.  
  4054.  
  4055.  
  4056.         "BIOS" connection at speeds exceeding 9600 baud, and will switch to
  4057.         a "Modem" connection if the specified speed is higher.
  4058.  
  4059.         the "Flow Control" setting
  4060.         ~~~~~~~~~~~~~~~~~~~~~~~~~~
  4061.         Turn all three sub-menu choices OFF;  that is, make sure the word
  4062.         "OFF" appears next to "XON/XOFF", "RTS/CTS", and "16550 FIFO"; they
  4063.         are all toggled with the RETURN key.
  4064.  
  4065.         This is done not only because the ComShare System handles all that,
  4066.         but also to prevent the TeleMate program from attempting to access
  4067.         the physical hardware of the Com Port (a GRAD has no physical
  4068.         hardware).
  4069.  
  4070.         Base Address, IRQ, and Interrupt
  4071.         ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  4072.         Leave these settings alone - they do not apply to a GRAD.
  4073.  
  4074.     5)  Finish installing TeleMate to your liking, then choose the "End
  4075.         Installation" item from the main menu.  Then choose the "Save Setup"
  4076.         item from the displayed sub-menu, which will end the TMINST program.
  4077.  
  4078.     6)  Load the file, "TM.CFG" into your favorite text editor, then change
  4079.         the line which reads, "Connection=Modem" to "Connection=Bios".  It
  4080.         takes up an entire line, and no characters appear before or after it.
  4081.         Once the line has been changed, save the entire file as a text file.
  4082.                                                                   ~~~~~~~~~
  4083.         If this is not a first time installation, the line may read
  4084.         "Connection=Computer" or "Connection=Fossil".  Regardless of its
  4085.         initial condition however, the change is the same.
  4086.  
  4087.         If you don't have a "favorite text editor", but you are using MS-DOS
  4088.         version 5.0 or later, you can use the text editor included with DOS,
  4089.         which is called "EDIT", by typing in "EDIT TM.CFG".  The Windows 3.1
  4090.         "NotePad" program can also be used.
  4091.  
  4092.     It is crucial that the last step, step 6, be performed BEFORE TeleMate
  4093.     is run, otherwise TeleMate, during its initialization, will attempt to
  4094.     access the physical hardware of the Com Port you chose in step 4, where
  4095.     none in fact exist.  If this should happen by accident, it is strongly
  4096.     advisable that you reboot your machine before proceeding.
  4097.  
  4098.  
  4099.     Setting Up The GRAD To Use With TeleMate
  4100.     ────────────────────────────────────────
  4101.  
  4102.     Before running the TeleMate program which has been set up to use a GRAD
  4103.     (see above), you must first "Open a Com Port" using either the USECOM
  4104.     or PICKCOM programs.  The exact steps involved in doing so are clearly
  4105.     outlined in the "How The ComShare System Works" sub-section at the
  4106.     beginning of this documentation, not to mention the other more detailed
  4107.     sections of this documentation, and therefore need not be repeated here.
  4108.  
  4109.     Worth mentioning however, is that the Com Port number of the Com Port
  4110.     you "Open" with the USECOM program, prior to invoking TeleMate, must
  4111.     match the Com Port number you previously set up TeleMate to use.
  4112.  
  4113.     THE COMSHARE SYSTEM                                     APPENDIX  -A-   71
  4114.  
  4115.  
  4116.  
  4117.     Using TeleMate With a GRAD
  4118.     ──────────────────────────
  4119.  
  4120.     Once the TeleMate program has been set up to use an "Opened" Com Port,
  4121.     ie: a Com Port which has been attached to a GRAD, and after that
  4122.     particular Com Port has successfully been Opened by the USECOM program,
  4123.     then the TeleMate program is ready to run.
  4124.  
  4125.     Once invoked, the TeleMate program's operation when using a GRAD is
  4126.     exactly the same as it would be if it were using a local, physical modem,
  4127.     with the following very important exceptions:
  4128.  
  4129.     1)  You must make sure that every single entry in the TeleMate phone
  4130.         book, as well as any new entries you create, which are intended
  4131.         for use with the USECOM-Opened Com Port, has:
  4132.  
  4133.         A)  A "Baud Rate" setting of 9600 OR LESS.  If it is specified any
  4134.             higher, TeleMate will change the entry's "Connection" setting
  4135.             to "Modem" (see below).
  4136.  
  4137.         B)  A "Connection" setting of "BIOS".  When editing a phone book
  4138.             entry under TeleMate (by pressing F6), each entry is divided into
  4139.             two pages.  The "Connection" setting is on the second page.
  4140.  
  4141.             Please Note:  This setting will have to be manually altered every
  4142.             time you create a new phone book entry, because the TeleMate
  4143.             program sets it to "Modem" by default.
  4144.  
  4145.     2)  Both the "Connection" and the "Flow Control" settings of the global
  4146.         "Terminal" Options should never be changed.  The "Baud Rate" setting
  4147.         of the global "Communication" Options should also never be set above
  4148.         9600 baud, or the "Connection" setting just mentioned will be
  4149.         automatically changed (by TeleMate).
  4150.  
  4151.     3)  Although, given its complexity, TeleMate version 4.12 is remarkably
  4152.         bug-free, it does have one bug which directly affects its ability to
  4153.         use a GRAD.  The following workaround is therefore necessary, at least
  4154.         until the bug is fixed in some future version of TeleMate.
  4155.  
  4156.         Before dialing any TeleMate phone book entry, you must first ensure
  4157.         that the "Baud Rate", "Parity", "Data Bits", and "Stop Bits" settings
  4158.         in TeleMate's global "Communication" Options exactly match those
  4159.         specified by the phone book entry you wish to dial.
  4160.  
  4161.         If one or more of these settings differ, TeleMate's global "Communi-
  4162.         cation" Options will have to be manually changed to match those found
  4163.         in the phone book's entry, BEFORE the number is dialed.
  4164.  
  4165.         TeleMate's global "Communication" Options can be viewed and/or changed
  4166.         by selecting "Options" from the main TeleMate menu (Alt-O), and then
  4167.         selecting "Communication" from the sub-menu that subsequently appears.
  4168.  
  4169.         Should you, by accident, attempt to dial a number before checking
  4170.         and/or changing the aforementioned settings, you are strongly advised
  4171.         to exit TeleMate, shutdown USECOM, and reboot your machine before
  4172.         proceeding any further.  The reason for this is that by that time,
  4173.  
  4174.     THE COMSHARE SYSTEM                                     APPENDIX  -A-   72
  4175.  
  4176.  
  4177.  
  4178.         TeleMate will have already attempted to access physical hardware that
  4179.         doesn't exist, and such an action compromises the integrity of your
  4180.         entire system.
  4181.  
  4182.         Fortunately however, the chances are good that you will not have to
  4183.         manually change the global "Communication" Options very often, largely
  4184.         because the majority of PC-based modem communications today takes
  4185.         place at the higher baud rates, using the standard "No parity, 8 Data
  4186.         bits, and 1 Stop Bit" protocol (N-8-1).  The glaring exception of
  4187.         course, is CompuServe, which uses Even parity and 7 Data bits.
  4188.  
  4189.     THE COMSHARE SYSTEM                                     APPENDIX  -B-   73
  4190.  
  4191.  
  4192.  
  4193.     APPENDIX B: USING THE COMSHARE SYSTEM WITH WINDOWS 3.1
  4194.     ══════════════════════════════════════════════════════════════════════════
  4195.  
  4196.  
  4197.     Because it may sometimes be desirable to run a communications package
  4198.     under MicroSoft Windows 3.1, the ComShare System was designed so that
  4199.     accessing a GRAD can also be achieved under Windows 3.1, through the
  4200.     use of either the USECOM or the PICKCOM programs.  The SHARECOM program
  4201.     however, cannot be run under Windows 3.1, but can be installed BEFORE
  4202.     Windows 3.1 is run.
  4203.  
  4204.     Before the USECOM program can effectively be employed to gain access to
  4205.     one or more GRADs on the network under Windows 3.1 however, the USECOM
  4206.     program must first be made resident in memory BEFORE Windows is loaded,
  4207.     with at least one unused character buffer.
  4208.  
  4209.     This can be achieved through the use of the USECOM program's "/BUFFER"
  4210.     command line option, such as in the following invocation:
  4211.  
  4212.     C:> USECOM /BUFF
  4213.  
  4214.     The above will make both the USECOM program code, and one unused character
  4215.     buffer, resident in memory.  If you plan to Open more than one Com Port
  4216.     under Windows, the above invocation may be repeated for as many Com Ports
  4217.     as will be Opened under Windows.  In other words, the number of Com Ports
  4218.     that can be Opened under Windows 3.1 is exactly equal to the number of
  4219.     unused character buffers that were installed in resident memory BEFORE
  4220.     Windows 3.1 was invoked.
  4221.  
  4222.     Once this prerequisite has been achieved, Opening and Closing Com Ports
  4223.     using the USECOM program can then be performed in the normal manner under
  4224.     any Windows 3.1 DOS box.
  4225.  
  4226.     Once Windows has been terminated, the resident memory taken up by the
  4227.     unused character buffers that were installed prior to its invocation may
  4228.     be released through the use of the USECOM program's "/RELEASE" command
  4229.     line option.  This is assuming, of course, that all Com Ports that were
  4230.     Opened under Windows were also Closed prior to terminating Windows, a
  4231.     practice which is, needless to say, highly recommended.
  4232.  
  4233.     Under Windows 3.1 then, a typical batch file to Open a Com Port, use it,
  4234.     then Close it before ending the task, might look something like this:
  4235.  
  4236.     @ECHO OFF
  4237.     USECOM /OPEN /GRAD=7 3
  4238.     if errorlevel 1 goto Error
  4239.     TM
  4240.     USECOM /CLOSE 3
  4241.     goto End
  4242.     :Error
  4243.     PAUSE
  4244.     :End
  4245.  
  4246.     The above assumes that the TeleMate program (TM.EXE) had previously been
  4247.     set up to use Com Port 3 (see APPENDIX A for details), that GRAD 7 had
  4248.     been created somewhere on the network, that the USECOM program exists in
  4249.  
  4250.     THE COMSHARE SYSTEM                                     APPENDIX  -B-   74
  4251.  
  4252.  
  4253.  
  4254.     a directory specified in the DOS PATH, and last but not least, that this
  4255.     batch file will itself be invoked by a Windows .PIF file akin to the one
  4256.     supplied with the TeleMate (ver 4.12) package.
  4257.  
  4258.     THE COMSHARE SYSTEM                                     APPENDIX  -C-   75
  4259.  
  4260.  
  4261.  
  4262.     APPENDIX C: THE COMSHARE SYSTEM API FOR PROGRAMMERS
  4263.     ══════════════════════════════════════════════════════════════════════════
  4264.  
  4265.  
  4266.     Programmers who are writing or have written PC-based telecommunications
  4267.     packages can very easily have such packages take full advantage of the
  4268.     modem-sharing capabilities of the ComShare System, by simply accessing
  4269.     the ComShare System's Application Program Interface (API), which is both
  4270.     simple and powerful.
  4271.  
  4272.     By using the ComShare System's API, any application can gain real-time
  4273.     access to any Com Port that exists over an entire network, without having
  4274.     to worry about any network-specific details.  In fact, the ComShare
  4275.     System's API is completely network-independent.
  4276.  
  4277.     Also, because the ComShare System's API is completely compatible with the
  4278.     industry standard IBM EBIOS (Extended BIOS) Interrupt 14h interface, which
  4279.     is a much more comprehensive superset of the original IBM BIOS version,
  4280.     using the ComShare System's API can be every bit as flexible as accessing
  4281.     the physical hardware of the Com Port itself.
  4282.  
  4283.     And due to its BIOS compatibility, the ComShare System's API can also be
  4284.     accessed in the C language if desired, by simply using the C language
  4285.     "_bios_serialcom" function available in both the MicroSoft and Borland
  4286.     C compilers.  The documentation for this function states that it should
  4287.     not be used for baud rates above 1200 - this caveat is NOT applicable
  4288.     when using the ComShare System (just so you know).
  4289.  
  4290.     There are other benefits to using the ComShare System's API as well.
  4291.     Buffering and Flow Control are all transparently taken care of by the
  4292.     ComShare System, so that once your application has detected a shared Com
  4293.     Port resource, which is done within the API itself (see function 36h,
  4294.     below), no more work need be done by your application in those areas.
  4295.  
  4296.     The ComShare System's API is implemented as an assembler-level interface
  4297.     that is exactly like the IBM EBIOS Interrupt 14h interface in every
  4298.     respect, except for the following minor differences:
  4299.  
  4300.     1)  The baud rate table for functions 0 and 4 (described in detail below)
  4301.         has been changed to include faster baud rates than were previously
  4302.         available at the time the original specs were made.  These include
  4303.         allowances for the newer baud rates, such as 14,400 and 28,800,
  4304.         which all replace the older, now obsolete baud rates, such as 110,
  4305.         150, 600, and 4800 baud.
  4306.  
  4307.         The ComShare System's baud rate table is:
  4308.  
  4309.                         0  -  19200 Baud        ( changed: was 110 Baud )
  4310.                         1  -  38400 Baud        ( changed: was 150 Baud )
  4311.                         2  -    300 Baud
  4312.                         3  -  14400 Baud        ( changed: was 600 Baud )
  4313.                         4  -   1200 Baud
  4314.                         5  -   2400 Baud
  4315.                         6  -  28800 Baud        ( changed: was 4800 Baud )
  4316.                         7  -   9600 Baud
  4317.                         8  -  19200 Baud
  4318.  
  4319.     THE COMSHARE SYSTEM                                     APPENDIX  -C-   76
  4320.  
  4321.  
  4322.  
  4323.                         9  -  38400 Baud        ( new: didn't exist before )
  4324.                        10  -  57600 Baud        ( new: didn't exist before )
  4325.                        11  - 115200 Baud        ( new: didn't exist before )
  4326.  
  4327.         Upon detection of a ComShare System Com Port resource therefore, the
  4328.         above table values should be assumed when calling the Interrupt 14h
  4329.         functions.
  4330.  
  4331.         Also, if working with the C language function, "_bios_serialcom", you
  4332.         might want to account for these differences by including definitions
  4333.         such as:
  4334.                      #define _COM_19200  _COM_110
  4335.  
  4336.     2)  The ComShare System has added a seventh function to the original IBM
  4337.         EBIOS Interrupt 14h specification's set of six, which serves as the
  4338.         ComShare System's Installation Check, and returns the version of
  4339.         ComShare installed, as well as a bit-mapped value indicating which
  4340.         logical com ports are currently installed.  The exact specification
  4341.         for this seventh function, function 36h, is as follows:
  4342.  
  4343.         INT 14h - Function 36h - COMSHARE SYSTEM INSTALLATION CHECK
  4344.         ═══════════════════════════════════════════════════════════
  4345.  
  4346.         Input:      AH = 36h
  4347.         ~~~~~       ~~
  4348.  
  4349.  
  4350.         Returns:    AX = 'CS'  ( hex 4353 )
  4351.         ~~~~~~~     ~~
  4352.  
  4353.                     BX = Bit-map of Installed Com ports, where:
  4354.                     ~~   Bit 3  --  set if Com port 4 is currently installed
  4355.                          Bit 2  --  set if Com port 3 is currently installed
  4356.                          Bit 1  --  set if Com port 2 is currently installed
  4357.                          Bit 0  --  set if Com port 1 is currently installed
  4358.  
  4359.                          -- Bits 4-15 are reserved for future use --
  4360.                                       (all zeros for version 1.00 )
  4361.  
  4362.                     CX = reserved for future use.
  4363.                     ~~   (preserved in version 1.00 )
  4364.  
  4365.             word at DX:[256] = ComShare version number, where:
  4366.                     ~~~~~~~~   high-order byte  --  major version number
  4367.                                low-order byte   --  minor version number
  4368.  
  4369.     3)  You cannot call any of the ComShare System's Interrupt 14h compatible
  4370.         functions (functions 0 - 5) with interrupts disabled.  If you do, the
  4371.         ComShare System's Interrupt 14h interface will simply return with the
  4372.         contents of all registers unchanged except for register AH, which will
  4373.         be set to 80h, indicating a timeout condition for the Port Status.
  4374.  
  4375.         This was done because ComShare has to enable interrupts to service
  4376.         Interrupt 14h requests, but to do so with interrupts disabled on entry
  4377.         would be to compromise the integrity of the Interrupt Flag's status.
  4378.  
  4379.     THE COMSHARE SYSTEM                                     APPENDIX  -C-   77
  4380.  
  4381.  
  4382.  
  4383.         In other words, if an application makes an Interrupt 14h request with
  4384.         the Interrupt Flag clear (ie: with interrupts disabled), it is assumed
  4385.         that this was done to prevent any maskable interrupts from occurring
  4386.         during the entire duration of the Interrupt 14h request, a condition
  4387.         under which the ComShare package's Interrupt 14h interface cannot
  4388.         operate, due to various network-related considerations.
  4389.  
  4390.     4)  Unlike the original IBM BIOS and EBIOS Interrupt 14h interfaces, the
  4391.         ComShare System's Interrupt 14h interface is not re-entrant as far
  4392.         as calls to the same logical com port number are concerned.
  4393.  
  4394.         If any of the ComShare System's Interrupt 14h compatible functions
  4395.         (functions 0 - 5) are called with DX set to a certain Com Port number,
  4396.         while ComShare is currently processing an Int 14h request for that
  4397.         same Com Port number, ComShare will simply return from the later call
  4398.         with the contents of all registers unchanged except for register AH,
  4399.         which will be set to 80h, indicating a timeout condition for the Port
  4400.         Status.  Obviously, however, this would only become a consideration
  4401.         for those applications wishing to call the Interrupt 14h interface
  4402.         from within a maskable interrupt's ISR (Interrupt Service Routine).
  4403.  
  4404.     Given the above differences, the ComShare System's assembler-level API is
  4405.     therefore exactly as follows, excluding the Installation Check function
  4406.     which was described earlier:
  4407.  
  4408.     THE COMSHARE SYSTEM                                     APPENDIX  -C-   78
  4409.  
  4410.  
  4411.  
  4412.     ╔═══════════════════════════════════════════════════════════════════════╗
  4413.     ║ - The NashaKala Corporation's Interrupt 14h Interface Specification - ║
  4414.     ║                                for the                                ║
  4415.     ║  ComShare TeleCommunications Resource Management System Version 1.00  ║
  4416.     ╚═══════════════════════════════════════════════════════════════════════╝
  4417.  
  4418.  
  4419.     INT 14h - Function 0 - INITIALIZE SERIAL COM PORT
  4420.     ═════════════════════════════════════════════════
  4421.  
  4422.     Input:      AH = 00h
  4423.     ~~~~~       ~~
  4424.  
  4425.                 DX = Port number: (0-3)
  4426.                 ~~
  4427.  
  4428.                 AL = initializing parameter bits
  4429.                 ~~
  4430.  
  4431.                 BITS for Register AL :
  4432.                 ~~~~~~~~~~~~~~~~~~~~
  4433.  
  4434.                   7 - 6 - 5        4 - 3        2       1 - 0
  4435.                   BAUD RATE        PARITY      STOP      WORD
  4436.                                                BITS     LENGTH
  4437.  
  4438.                 000:  19200 bd    00:  none    0: 1     00:  5
  4439.                 001:  38400 bd    01:  odd     1: 2     01:  6
  4440.                 010:    300 bd    11:  even             10:  7
  4441.                 011:  14400 bd                          11:  8
  4442.                 100:   1200 bd
  4443.                 101:   2400 bd
  4444.                 110:  28800 bd
  4445.                 111:   9600 bd
  4446.                 ═══════╤══════
  4447.                        ╘══════════> ( NASHAKALA CORP. BAUD RATE TABLE )
  4448.  
  4449.  
  4450.     Returns:    AX = Modem and Port status codes ( see Function 3, below )
  4451.     ~~~~~~~     ~~
  4452.  
  4453.     THE COMSHARE SYSTEM                                     APPENDIX  -C-   79
  4454.  
  4455.  
  4456.  
  4457.     INT 14h - Function 1 - SEND CHARACTER
  4458.     ═════════════════════════════════════
  4459.  
  4460.     Input:      AH = 01h
  4461.     ~~~~~       ~~
  4462.  
  4463.                 AL = character to be sent
  4464.                 ~~
  4465.  
  4466.                 DX = Port number (0-3)
  4467.                 ~~
  4468.  
  4469.  
  4470.     Returns:    AH = Port status ( see Function 3, below )
  4471.     ~~~~~~~     ~~
  4472.  
  4473.  
  4474.  
  4475.     INT 14h - Function 2 - RECEIVE CHARACTER
  4476.     ════════════════════════════════════════
  4477.  
  4478.     Input:      AH = 02h
  4479.     ~~~~~       ~~
  4480.  
  4481.                 DX = Port number (0-3)
  4482.                 ~~
  4483.  
  4484.  
  4485.     Returns:    AL = character received
  4486.     ~~~~~~~     ~~
  4487.  
  4488.                 AH = Port status ( see Function 3, below )
  4489.                 ~~
  4490.  
  4491.     THE COMSHARE SYSTEM                                     APPENDIX  -C-   80
  4492.  
  4493.  
  4494.  
  4495.     INT 14h - Function 3 - READ SERIAL PORT STATUS
  4496.     ══════════════════════════════════════════════
  4497.  
  4498.     Input:      AH = 03h
  4499.     ~~~~~       ~~
  4500.  
  4501.                 DX = Port number (0-3)
  4502.                 ~~
  4503.  
  4504.  
  4505.     Returns:    AH = Port status code bits:
  4506.     ~~~~~~~     ~~
  4507.                      0: data ready
  4508.                      1: overrun error
  4509.                      2: parity error
  4510.                      3: framing error
  4511.                      4: break detected
  4512.                      5: transmission buffer register empty
  4513.                      6: transmission shift register empty
  4514.                      7: time out--if set, other bits invalid
  4515.  
  4516.                 AL = Modem status code bits:
  4517.                 ~~
  4518.                      0: change in Clear-To-Send detected
  4519.                      1: change in Data-Set-Ready detected
  4520.                      2: trailing edge of ring detected
  4521.                      3: change in receive line signal detected
  4522.                      4: Clear-To-Send
  4523.                      5: Data-Set-Ready
  4524.                      6: ring detected
  4525.                      7: receive line signal detected
  4526.  
  4527.     THE COMSHARE SYSTEM                                     APPENDIX  -C-   81
  4528.  
  4529.  
  4530.  
  4531.     INT 14h - Function 4 - EXTENDED INITIALIZE
  4532.     ══════════════════════════════════════════
  4533.  
  4534.     Input:      AH = 04h
  4535.     ~~~~~       ~~
  4536.  
  4537.                 DX = Port number (0-3)
  4538.                 ~~
  4539.  
  4540.                 AL = Break, where:
  4541.                 ~~   00h - No break
  4542.                      01h - Send Break
  4543.  
  4544.                 BH = Parity, where:
  4545.                 ~~   00h - None
  4546.                      01h - Odd
  4547.                      02h - Even
  4548.                      03h - Stick parity Odd
  4549.                      04h - Stick parity Even
  4550.  
  4551.                 BL = Stop Bit, where:
  4552.                 ~~   00h - One stop bit
  4553.                      01h - Two stop bits if 6, 7, or 8 bit word length, else
  4554.                            One and a half stop bits if 5-bit word length.
  4555.  
  4556.                 CH = Word length, where:
  4557.                 ~~   00h - 5 Bits
  4558.                      01h - 6 Bits
  4559.                      02h - 7 Bits
  4560.                      03h - 8 Bits
  4561.  
  4562.                 CL = Baud Rate, where:
  4563.                 ~~   00h -  19200 Baud
  4564.                      01h -  38400 Baud
  4565.                      02h -    300 Baud
  4566.                      03h -  14400 Baud
  4567.                      04h -   1200 Baud
  4568.                      05h -   2400 Baud
  4569.                      06h -  28800 Baud
  4570.                      07h -   9600 Baud
  4571.                      08h -  19200 Baud
  4572.                      09h -  38400 Baud
  4573.                      0Ah -  57600 Baud
  4574.                      0Bh - 115200 Baud
  4575.                      ═══════╤════════
  4576.                             ╘════════════> ( NASHAKALA CORP. BAUD RATE TABLE )
  4577.  
  4578.  
  4579.     Returns:    AX = Modem and Port status codes ( see Function 3, above )
  4580.     ~~~~~~~     ~~
  4581.  
  4582.     THE COMSHARE SYSTEM                                     APPENDIX  -C-   82
  4583.  
  4584.  
  4585.  
  4586.     INT 14h - Function 5 - EXTENDED SERIAL PORT CONTROL
  4587.     ═══════════════════════════════════════════════════
  4588.  
  4589.     Input:      AH = 05h
  4590.     ~~~~~       ~~
  4591.  
  4592.                 DX = Port number (0-3)
  4593.                 ~~
  4594.  
  4595.                 AL = Modem Control Access function
  4596.                 ~~   00h  -  Read the Modem Control Register into register BL.
  4597.                      01h  -  Write register BL to the Modem Control Register.
  4598.  
  4599.                 BL = Modem Control Register Value to Write if AL=01h
  4600.                 ~~   Bit 4  --  Loopback enable / disable
  4601.                      Bit 3  --  OUT2 enable / disable
  4602.                      Bit 2  --  OUT1 enable / disable
  4603.                      Bit 1  --  RTS enable / disable
  4604.                      Bit 0  --  DTR enable / disable
  4605.  
  4606.  
  4607.     Returns:    AX = Modem and Port status codes ( see Function 3, above )
  4608.     ~~~~~~~     ~~
  4609.  
  4610.                 BL = Current Modem Control Register Value if AL=00h
  4611.                 ~~
  4612.  
  4613.     THE COMSHARE SYSTEM                                     APPENDIX  -D-   83
  4614.  
  4615.  
  4616.  
  4617.     APPENDIX D: TROUBLESHOOTING
  4618.     ══════════════════════════════════════════════════════════════════════════
  4619.  
  4620.  
  4621.     PROBLEM:  TeleMate fails to initialize the modem when using a GRAD.
  4622.     ~~~~~~~
  4623.  
  4624.     SOLUTION:  There are two main possible causes for this, which are:
  4625.  
  4626.                1)  The TeleMate program may not have been properly configured
  4627.                    to communicate to its default Com Port through the 'BIOS'
  4628.                    interface.
  4629.  
  4630.                    In order to use the TeleMate program with the ComShare
  4631.                    System, TeleMate must first be configured to use the 'BIOS'
  4632.                    interface to communicate to all Com Ports, instead of
  4633.                    accessing the physical hardware of the Com Port itself.
  4634.                    This is a little like configuring certain programs to use
  4635.                    'BIOS' screen writes instead of 'direct' screen writes.
  4636.                    Same idea, different peripheral.
  4637.  
  4638.                    You can see whether or not the TeleMate program is using
  4639.                    the 'BIOS' by default, by choosing the 'Options' item from
  4640.                    TeleMate's main menu (Alt-O), then choosing the 'Terminal'
  4641.                    menu item.  In the 'Connection' settings box that
  4642.                    subsequently appears, the 'BIOS' item should be checked.
  4643.                    If it is not, TeleMate has not been properly configured
  4644.                    to work with the ComShare System.
  4645.  
  4646.                2)  The TeleMate program may not have been properly configured
  4647.                    to use the right Com Port.  If either the USECOM or the
  4648.                    PICKCOM program is used to 'Open' Com Port 3 for example,
  4649.                    but TeleMate is set up to use Com Port 4 by default, then
  4650.                    obviously the TeleMate program will not be communicating
  4651.                    with the right Com Port when it attempts to initialize it.
  4652.  
  4653.                    You can view (or change) TeleMate's default Com Port
  4654.                    setting by choosing the 'Options' item from TeleMate's
  4655.                    main menu (Alt-O), then choosing the 'Communication' menu
  4656.                    item.  In the 'Com Port' settings box that subsequently
  4657.                    appears, the default Com Port that TeleMate is using will
  4658.                    be checked.
  4659.  
  4660.                The solution to both problems is to ensure that the TeleMate
  4661.                program is configured properly to work with the ComShare
  4662.                System, the exact procedures for which are specified in
  4663.                APPENDIX A of this documentation.  APPENDIX A should be read
  4664.                in its entirety before using the TeleMate program with the
  4665.                ComShare System.
  4666.  
  4667.  
  4668.     PROBLEM:  When online using a GRAD, characters received remotely or typed
  4669.     ~~~~~~~   in directly appear as periodic, multiple-character 'blocks',
  4670.               with extremely small (but noticeable) delays occurring between
  4671.               them.
  4672.  
  4673.     THE COMSHARE SYSTEM                                     APPENDIX  -D-   84
  4674.  
  4675.  
  4676.  
  4677.     SOLUTION:  The solution here is in realizing that this is precisely how
  4678.                the ComShare System is supposed to work.
  4679.  
  4680.                In order to communicate effectively with a Com Port across a
  4681.                network without taxing the capabilities of the network to a
  4682.                ridiculous degree, the characters either sent to, or received
  4683.                from, that Com Port must be 'buffered'.  'Buffering' in this
  4684.                case means that characters are not immediately sent out across
  4685.                the network as soon as they are manifested, which would
  4686.                increase network traffic enormously, but instead, are added
  4687.                to an internal 'character buffer' existing in memory, which
  4688.                is then sent out across the network as a block when either
  4689.                the buffer becomes full, or a fifth of a second has elapsed
  4690.                since the last time the buffer was sent.
  4691.  
  4692.                The observed delay between the typing of characters and their
  4693.                appearance on the screen is therefore quite necessary to the
  4694.                overall efficiency of the system.
  4695.  
  4696.                The apparent inconvenience of these extremely small delays is
  4697.                illusory however, as it usually only takes about five minutes
  4698.                of use to become fully accustomed to them.
  4699.  
  4700.  
  4701.     PROBLEM:  Pop-up Windows in the INSTALL and PICKCOM programs appear dim
  4702.     ~~~~~~~   or completely blank when running on an LCD or other type of
  4703.               "Grey Scale" monitor.
  4704.  
  4705.     SOLUTION:  Invoke both the INSTALL and PICKCOM programs with the "/M"
  4706.                command line option, as in "INSTALL /M".
  4707.  
  4708.                The "/M" command line option forces the invoked program to
  4709.                run in "Black and White" (Monochrome) mode.
  4710.  
  4711.                This is necessary when running a color card with a "Grey Scale"
  4712.                type of monitor because some colors, like brown and yellow, are
  4713.                translated by the hardware into very similar "shades of grey"
  4714.                on these systems, and therefore can produce indistinguishable
  4715.                background and foreground colors, which make some of the
  4716.                screens very hard to read.
  4717.  
  4718.  
  4719.     PROBLEM:  INSTALL.EXE takes a long time to load once it is invoked.
  4720.     ~~~~~~~
  4721.  
  4722.     SOLUTION:  This is not a problem !  The ComShare System INSTALL program
  4723.                can take anywhere from 7 to 10 seconds to load on very slow
  4724.                8088 or 286 machines running at 8 Mhz or below.
  4725.  
  4726.                This is because the INSTALL program must do a number of things
  4727.                before it can invoke its menu system, the execution time for
  4728.                which will only be noticeable on slower machines.
  4729.  
  4730.  
  4731.     PROBLEM:  The INSTALL program locks up the machine.
  4732.     ~~~~~~~
  4733.  
  4734.     THE COMSHARE SYSTEM                                     APPENDIX  -D-   85
  4735.  
  4736.  
  4737.  
  4738.     SOLUTION:  Certain TSR's which attempt to take an inordinate amount of
  4739.                control away from DOS can cause the machine to lock up when
  4740.                the INSTALL program is run.  This is *not* the fault of the
  4741.                INSTALL program, but it does mean that the offending TSR will
  4742.                have to be removed from memory before the INSTALL program can
  4743.                be run.
  4744.  
  4745.                Fortunately, the only known case of this ever happening is
  4746.                with the SideKick program, version 1.51.
  4747.                         ~~~~~~~~          ~~~~~~~~~~~~
  4748.  
  4749.                As of this writing, versions of the SideKick program later
  4750.                than version 1.51 have not been tested.  It is possible
  4751.                therefore that later versions may also need to be removed
  4752.                from memory before starting the Install program.
  4753.  
  4754.                If your machine hangs when the INSTALL program is run then,
  4755.                it is due to a TSR program which is trying unsuccessfully to
  4756.                "fake out" MS-DOS, and must be removed before running the
  4757.                INSTALL program.
  4758.  
  4759.  
  4760.     PROBLEM:  Communications session using a GRAD goes "haywire", or stops
  4761.     ~~~~~~~   altogether.
  4762.  
  4763.     SOLUTION:  There are a number of different possible causes for this, all
  4764.                of which are completely avoidable:
  4765.  
  4766.                1)  If you are using the Tryware version of the ComShare
  4767.                    System, the problem is most probably caused by the fact
  4768.                    that the network connection existing between your machine
  4769.                    and the GRAD you are using has lasted longer than the
  4770.                    30 minute time limit imposed by the Tryware version.
  4771.  
  4772.                    For more information on the 30 minute Tryware limit, please
  4773.                    consult the "How The ComShare System is Distributed" sub-
  4774.                    section of the "GETTING STARTED" section of this document-
  4775.                    ation.
  4776.  
  4777.                    An obvious solution to the above problem would be to limit
  4778.                    yourself to only the first 25 minutes of the 30 minute
  4779.                    Tryware limit, thereby leaving yourself 5 minutes as a
  4780.                    comfortable buffer.
  4781.  
  4782.                2)  For either the Tryware or Registered versions of the
  4783.                    ComShare System, another cause of this problem might be
  4784.                    that the machine on which the GRAD physically resides has
  4785.                    been rebooted.  This, of course, will kill the network
  4786.                    connection existing between the GRAD and your machine.
  4787.  
  4788.                    The solution to the problem in this case is twofold:
  4789.  
  4790.                    A)  When installing the SHARECOM program for the first
  4791.                        time on any machine, be sure to include the "/GUARD"
  4792.                        command line option; this will load into memory an
  4793.                        additional resident program which pops up a warning
  4794.  
  4795.     THE COMSHARE SYSTEM                                     APPENDIX  -D-   86
  4796.  
  4797.  
  4798.  
  4799.                        notice whenever a soft reboot (Ctrl-Alt-Del) is
  4800.                        attempted;  -and-
  4801.  
  4802.                    B)  Anyone who is using, or will use, a machine on which
  4803.                        one or more active GRADs are installed should be made
  4804.                        aware of the fact that turning off the machine should
  4805.                        only be done after Closing all Opened Com Ports,
  4806.                        preferably with the SHARECOM program's "/DISABLE"
  4807.                        command line option.
  4808.  
  4809.                        The advantage of using this option to Close all Opened
  4810.                        Com Ports is that it will not change the status of any
  4811.                        GRAD if one of them is currently being used, thereby
  4812.                        ensuring the integrity of any ongoing communications
  4813.                        sessions.
  4814.  
  4815.                3)  Another possible cause of this type of problem might be
  4816.                    that the processing power of the machine on which the
  4817.                    GRADs physically reside is not sufficient to handle the
  4818.                    total network and modem traffic generated by the Com Ports
  4819.                    which have been made shareable.
  4820.  
  4821.                    The solution therefore, may simply be to share fewer Com
  4822.                    Ports on that machine, or to 'dedicate' that machine to
  4823.                    the task of sharing Com Ports only.  For more information
  4824.                    on the subject of the raw processing power necessary to
  4825.                    share Com Ports effectively, the sub-section entitled,
  4826.                    "Minimum System Requirements" in the "GETTING STARTED"
  4827.                    section of this documentation can be consulted.
  4828.  
  4829.                4)  Lastly, and again for both the Tryware and Registered
  4830.                    versions of the product, an additional cause of serious
  4831.                    disruption in GRAD access can occur if either the pause
  4832.                    key, or a memory resident pop-up utility, is used on the
  4833.                    machine in which the GRAD physically resides.
  4834.  
  4835.                    Although using the pause key or invoking a memory resident
  4836.                    pop-up utility on the GRAD's host machine is not guaranteed
  4837.                    to disrupt a GRAD's functionality across the network, the
  4838.                    chances are good that it will do just that.
  4839.  
  4840.                    This is because pressing either the pause key or the "hot
  4841.                    key" of a memory resident utility serves to suspend exec-
  4842.                    ution of whatever was running on the machine at the time,
  4843.                    which could just as easily be the SHARECOM program's
  4844.                    resident code as anything else, because it gets executed
  4845.                    intermittently on the machine to handle the network
  4846.                    traffic coming in for the GRAD.
  4847.  
  4848.                    The use of either the pause key or memory resident pop-up
  4849.                    utilities is therefore to be avoided on those machines
  4850.                    which have one or more GRADs installed.  This point is
  4851.                    made earlier in the "Opening A Com Port" sub-section of
  4852.                    the "MAKING A COM PORT SHAREABLE" section of this
  4853.                    documentation.
  4854.  
  4855.     THE COMSHARE SYSTEM                                     APPENDIX  -D-   87
  4856.  
  4857.  
  4858.  
  4859.                    Work is currently under way however, to remove this limit-
  4860.                    ation from future versions of the ComShare System.
  4861.  
  4862.  
  4863.     PROBLEM:  The USECOM program fails to connect to a GRAD which was selected
  4864.     ~~~~~~~   using the PICKCOM program.
  4865.  
  4866.     SOLUTION:  This will occur in those rare circumstances when a GRAD is
  4867.                connected to by another machine on the network between the
  4868.                time the PICKCOM program detects it as an available GRAD, and
  4869.                the time the USECOM program is used to make the actual
  4870.                connection.
  4871.  
  4872.                This is not as confusing as it may sound however.  By way of
  4873.                example, suppose GRAD 6 exists on the network and is available
  4874.                to connect to when the PICKCOM program is invoked.  The PICKCOM
  4875.                program will detect it as an available GRAD during its GRAD
  4876.                search phase, after which it will invoke its menu system.
  4877.  
  4878.                Within the PICKCOM program's menu system therefore, GRAD 6 will
  4879.                be listed as an available GRAD.  No further checking is done
  4880.                by the PICKCOM program after that however, to ensure that GRAD
  4881.                6 *remains* available throughout the entire GRAD selection
  4882.                process.  If another machine on the network connects to GRAD 6
  4883.                while you are still using the PICKCOM program therefore, GRAD
  4884.                6 will no longer be available to connect to by the time the
  4885.                PICKCOM program invokes the USECOM program to connect to it,
  4886.                and the connection attempt will therefore fail.
  4887.  
  4888.                Although not a big problem, work is currently under way to
  4889.                enhance the functionality of the PICKCOM program in future
  4890.                versions to make it better able to track and report changes
  4891.                in a GRADs status which may occur while the program is running.
  4892.  
  4893.  
  4894.     PROBLEM:  When using the TeleMate program with a GRAD, the machine
  4895.     ~~~~~~~   suddenly locks up.
  4896.  
  4897.     SOLUTION:  This can occur if the TeleMate program has inadvertently tried
  4898.                to program the physical hardware of the Com Port directly,
  4899.                without going through the 'BIOS'.  If it does so, it will be
  4900.                attempting to write to physical hardware that does not, in
  4901.                fact, physically exist on the machine, which can cause the
  4902.                machine to lock up any time after the access is attempted.
  4903.  
  4904.                The guidelines for preventing the TeleMate program from
  4905.                attempting such unauthorized access are clearly documented
  4906.                however, in APPENDIX A of this documentation entitled, "USING
  4907.                THE COMSHARE SYSTEM WITH TELEMATE" and if followed will ensure
  4908.                completely trouble-free operation.
  4909.  
  4910.     THE COMSHARE SYSTEM                                     APPENDIX  -E-   88
  4911.  
  4912.  
  4913.  
  4914.     APPENDIX E: ERROR MESSAGES
  4915.     ══════════════════════════════════════════════════════════════════════════
  4916.  
  4917.  
  4918.     If either the SHARECOM, USECOM, PICKCOM, or INSTALL programs encounter an
  4919.     error during the normal course of their operation, they will abort their
  4920.     current processing, issue an error message to the console, and exit to
  4921.     DOS with a return code specific to the error detected.  If no error is
  4922.     encountered, they will simply exit to DOS with a return code of zero
  4923.     once processing has been completed.
  4924.  
  4925.     For the sake of simplicity and ease of use, the first 16 types of errors,
  4926.     ie: those with DOS return codes of less than 17, are virtually identical
  4927.     in both the SHARECOM and USECOM programs.
  4928.  
  4929.  
  4930.     SHARECOM Error Messages
  4931.     ───────────────────────
  4932.  
  4933.     For the SHARECOM program, the types of errors that can be reported, their
  4934.     associated DOS return codes, and a brief explanation, are as follows:
  4935.  
  4936.  
  4937.                          SHARECOM Error Message                     DOS Return
  4938.                          ~~~~~~~~~~~~~~~~~~~~~~                        Code
  4939.  
  4940.  
  4941.     DOS Version 3.1 or better is required . . . . . . . . . . . . . . .  1
  4942.  
  4943.      An attempt was made to invoke the SHARECOM program under a
  4944.       version of the DOS operating system older than version 3.1.
  4945.  
  4946.      See "Minimum System Requirements" in the "GETTING STARTED"
  4947.       section of this documentation for further details.
  4948.  
  4949.  
  4950.     <network type> is not installed . . . . . . . . . . . . . . . . . .  2
  4951.  
  4952.      This error occurs when the specified network software, either
  4953.       NETBIOS or IPX/SPX, is not installed when the SHARECOM program
  4954.       is invoked.  The network software must be installed before
  4955.       invoking SHARECOM.
  4956.  
  4957.  
  4958.     SHARECOM is already resident in memory  . . . . . . . . . . . . . .  3
  4959.  
  4960.      The "/LOAD" option was used to load SHARECOM's resident program
  4961.       code into memory, but it was already resident at the time.  This
  4962.       is a benign error, as the request did not really "fail".
  4963.  
  4964.  
  4965.     Unbalanced quoted string on command line  . . . . . . . . . . . . .  4
  4966.  
  4967.      This error occurs when a quotation mark appears on the command
  4968.       line without a corresponding closing quotation mark.
  4969.  
  4970.     THE COMSHARE SYSTEM                                     APPENDIX  -E-   89
  4971.  
  4972.  
  4973.  
  4974.      See "The SHARECOM Program" in the "MAKING A COM PORT SHAREABLE"
  4975.       section of this documentation for further details.
  4976.  
  4977.  
  4978.     Cannot understand command line option, "<option>" . . . . . . . . .  5
  4979.  
  4980.      This error occurs when a '/' or a '-' character precedes an
  4981.       entry on the command line which cannot be interpreted as a
  4982.       valid SHARECOM option.
  4983.  
  4984.      See "The SHARECOM Program" in the "MAKING A COM PORT SHAREABLE"
  4985.       section of this documentation for further details.
  4986.  
  4987.  
  4988.     Invalid value specified for command line option, "<option>" . . . .  6
  4989.  
  4990.      An invalid parameter value was specified for the quoted option.
  4991.  
  4992.      See "The SHARECOM Program" in the "MAKING A COM PORT SHAREABLE"
  4993.       section of this documentation for further details.
  4994.  
  4995.  
  4996.     Invalid Com Port number: "<number>" . . . . . . . . . . . . . . . .  7
  4997.  
  4998.      This error occurs whenever the Com Port number specified on
  4999.       the command line, which is assumed to be any command line
  5000.       entry not preceded by a '/' or a '-' character, is not a
  5001.       number between 1 and 4.
  5002.  
  5003.      See "The SHARECOM Program" in the "MAKING A COM PORT SHAREABLE"
  5004.       section of this documentation for further details.
  5005.  
  5006.  
  5007.     GRAD number exceeds License in option, "<option>" . . . . . . . . .  8
  5008.  
  5009.      This error occurs when the GRAD number specified as a parameter
  5010.       value to the quoted option is a number greater than the maximum
  5011.       GRAD number allowed for by the current ComShare System License.
  5012.  
  5013.      The maximum GRAD number allowed is the same as the maximum number
  5014.       of concurrently existent GRADs allowed for by the License.
  5015.  
  5016.      See "How The ComShare System is Distributed" in the
  5017.       "INTRODUCTION" section of this documentation for further details.
  5018.  
  5019.  
  5020.     Node Registration failed  . . . . . . . . . . . . . . . . . . . . .  9
  5021.  
  5022.      For the NetBIOS version, this means that the SHARECOM program
  5023.       was unable to add the "machine name", which is formed from the
  5024.       NetBIOS "Adapter Status ID", to the NetBIOS network.  This
  5025.       should never happen.
  5026.  
  5027.      For the IPX/SPX version, this means that the SHARECOM program
  5028.       was unable to open socket number 5000 hex, which would mean
  5029.       that some other resident utility on the same machine was using
  5030.  
  5031.     THE COMSHARE SYSTEM                                     APPENDIX  -E-   90
  5032.  
  5033.  
  5034.  
  5035.       that particular socket number at the time.
  5036.  
  5037.  
  5038.     Com Port <number> is already Open . . . . . . . . . . . . . . . . . 10
  5039.  
  5040.      An attempt was made to Open a Com Port which was already Open.
  5041.  
  5042.  
  5043.     Com Port <number> is already Closed . . . . . . . . . . . . . . . . 11
  5044.  
  5045.      An attempt was made to Close a Com Port which was not Open.
  5046.  
  5047.  
  5048.     No Com Ports are available to Open  . . . . . . . . . . . . . . . . 12
  5049.  
  5050.      An attempt was made to Open the first available Com Port, but
  5051.       all Com Ports were either already Open or inaccessible.
  5052.  
  5053.      If desired, the "/STATUS" command line option can be used to
  5054.       Ascertain the Status, which will reveal the current status of
  5055.       all four Com Ports.
  5056.  
  5057.  
  5058.     No Com Ports are in use - Close Request ignored . . . . . . . . . . 13
  5059.  
  5060.      An attempt was made to Close the first available Open Com
  5061.       Port, but no Com Ports were found to be Open or "In Session".
  5062.  
  5063.  
  5064.     Cannot disable SHARECOM - all buffers cannot be released  . . . . . 14
  5065.  
  5066.      This error may occur in response to a "/DISABLE" or "/SHUTDOWN"
  5067.       request, and means that SHARECOM cannot be disabled because one
  5068.       or more blocks of another program's resident memory exists above
  5069.       one or more of SHARECOM's resident character buffers, preventing
  5070.       them from being released.
  5071.  
  5072.      If this error occurs, the status of the resident SHARECOM
  5073.       program is unchanged.
  5074.  
  5075.      See "Memory Considerations" in the "MAKING A COM PORT SHAREABLE"
  5076.       section of this documentation for further details.
  5077.  
  5078.  
  5079.     Cannot disable SHARECOM - resident code cannot be released  . . . . 15
  5080.  
  5081.      This error may occur in response to a "/DISABLE" or "/SHUTDOWN"
  5082.       request, and means that SHARECOM cannot be disabled because one
  5083.       or more blocks of another program's resident memory exists above
  5084.       the SHARECOM program's resident program code, preventing it from
  5085.       being released.
  5086.  
  5087.      If this error occurs, the status of the resident SHARECOM
  5088.       program is unchanged.
  5089.  
  5090.     THE COMSHARE SYSTEM                                     APPENDIX  -E-   91
  5091.  
  5092.  
  5093.  
  5094.      See "Memory Considerations" in the "MAKING A COM PORT SHAREABLE"
  5095.       section of this documentation for further details.
  5096.  
  5097.  
  5098.     Version is incompatible with Version already installed  . . . . . . 16
  5099.  
  5100.      This error occurs when the SHARECOM program being invoked has
  5101.       a different version number than the SHARECOM program currently
  5102.       resident in memory.
  5103.  
  5104.  
  5105.     All available GRAD numbers are in use (time to upgrade?)  . . . . . 17
  5106.  
  5107.      An attempt was made to Open a Com Port but failed because the
  5108.       GRAD that would have been created would have exceeded the
  5109.       maximum number of concurrently existent GRADs allowed for by
  5110.       the License.
  5111.  
  5112.      See "How The ComShare System is Distributed" in the
  5113.       "INTRODUCTION" section of this documentation for further details.
  5114.  
  5115.  
  5116.     Cannot disable SHARECOM - Com Port <number> is In Session . . . . . 18
  5117.  
  5118.      This error may occur in response to a "/DISABLE" request, and
  5119.       means that SHARECOM cannot be disabled because one or more of
  5120.       the installed GRADs are currently being used.
  5121.  
  5122.      If this error occurs, the status of the resident SHARECOM
  5123.       program is unchanged.
  5124.  
  5125.      This error message can be overridden by using the "/SHUTDOWN"
  5126.       command line option which, except for the possible generation
  5127.       of this error message, is otherwise synonymous with the
  5128.       "/DISABLE" command line option.
  5129.  
  5130.  
  5131.     Cannot Close Com Port <number> - buffer cannot be released  . . . . 19
  5132.  
  5133.      An attempt was made to Close a Com Port, but the attempt failed
  5134.       because the Open Com Port's resident character buffer could not
  5135.       be released without creating a "hole" in memory.  If this error
  5136.       occurs, the Com Port will remain Open.
  5137.  
  5138.      See "Memory Considerations" in the "MAKING A COM PORT SHAREABLE"
  5139.       section of this documentation for further details.
  5140.  
  5141.  
  5142.     The UART's HEX port address is required for Com Port <number> . . . 20
  5143.  
  5144.      This error occurs when the SHARECOM program cannot Open the
  5145.       specified Com Port because it does not know its hexidecimal
  5146.       port address, and no known default value exists.
  5147.  
  5148.  
  5149.     The IRQ number is required for Com Port <number>  . . . . . . . . . 21
  5150.  
  5151.     THE COMSHARE SYSTEM                                     APPENDIX  -E-   92
  5152.  
  5153.  
  5154.  
  5155.      This error occurs when the SHARECOM program cannot Open the
  5156.       specified Com Port because it does not know its IRQ number,
  5157.       and no known default value exists.
  5158.  
  5159.  
  5160.     No UART found at port address: <hex address>  . . . . . . . . . . . 22
  5161.  
  5162.      This error occurs when the UART chip, the fundamental circuitry
  5163.       of a Com Port, is not detected at the specified port address.
  5164.  
  5165.      If a hex port address was explicitly specified on the command
  5166.       line, this error message indicates that it is incorrect.  If no
  5167.       hex port address was explicitly specified on the command line,
  5168.       this error message means that the default value assumed by the
  5169.       SHARECOM program for this Com Port is incorrect, and a new hex
  5170.       port address must be explicitly specified on the command line.
  5171.  
  5172.      This error message may also appear if the SHARECOM program is
  5173.       invoked while running under Windows 3.1.  The SHARECOM program
  5174.       should not be invoked under Windows 3.1 under any circumstances.
  5175.       There is no problem with running Windows 3.1 AFTER the SHARECOM
  5176.       program has been made resident however.
  5177.  
  5178.  
  5179.     "<option>" - IRQ number is beyond the range of this machine . . . . 23
  5180.  
  5181.      This error occurs when the IRQ number, specified as a parameter
  5182.       value to the quoted option, is not a valid IRQ for the given
  5183.       machine which, for a PC/XT, is any number above 7, and for a
  5184.       PC/AT or better, is any number above 15.
  5185.  
  5186.  
  5187.     This Port's IRQ (<IRQ>) is currently in use . . . . . . . . . . . . 24
  5188.  
  5189.      This error occurs when the SHARECOM program cannot Open a
  5190.       Com Port because the specified IRQ is currently being used
  5191.       by another application.  This could mean that the Com Port
  5192.       is already being used by another program, but it could also
  5193.       mean that the IRQ number, either assumed or explicitly
  5194.       specified on the command line, is incorrect for the Com Port
  5195.       for which the Open attempt is being made.
  5196.  
  5197.  
  5198.     No Interrupts are being generated on IRQ <IRQ>  . . . . . . . . . . 25
  5199.  
  5200.      This error occurs when the SHARECOM program cannot Open a
  5201.       Com Port because the specified IRQ is not generating the
  5202.       proper interrupts.  This is most likely due to the fact
  5203.       that the IRQ number, either assumed or explicitly specified
  5204.       on the command line, is incorrect for the Com Port for which
  5205.       the Open attempt is being made.
  5206.  
  5207.      The only other explanation for the appearance of this error
  5208.       message is a failure of the Com Port's physical hardware.
  5209.  
  5210.     THE COMSHARE SYSTEM                                     APPENDIX  -E-   93
  5211.  
  5212.  
  5213.  
  5214.     USECOM Error Messages
  5215.     ─────────────────────
  5216.  
  5217.     For the USECOM program, the types of errors that can be reported, their
  5218.     associated DOS return codes, and a brief explanation, are as follows:
  5219.  
  5220.  
  5221.                           USECOM Error Message                      DOS Return
  5222.                           ~~~~~~~~~~~~~~~~~~~~                         Code
  5223.  
  5224.  
  5225.     DOS Version 3.1 or better is required . . . . . . . . . . . . . . .  1
  5226.  
  5227.      An attempt was made to invoke the USECOM program under a
  5228.       version of the DOS operating system older than version 3.1.
  5229.  
  5230.      See "Minimum System Requirements" in the "GETTING STARTED"
  5231.       section of this documentation for further details.
  5232.  
  5233.  
  5234.     <network type> is not installed . . . . . . . . . . . . . . . . . .  2
  5235.  
  5236.      This error occurs when the specified network software, either
  5237.       NETBIOS or IPX/SPX, is not installed when the USECOM program
  5238.       is invoked.  The network software must be installed before
  5239.       invoking USECOM.
  5240.  
  5241.  
  5242.     USECOM is already resident in memory  . . . . . . . . . . . . . . .  3
  5243.  
  5244.      The "/LOAD" option was used to load USECOM's resident program
  5245.       code into memory, but it was already resident at the time.  This
  5246.       is a benign error, as the request did not really "fail".
  5247.  
  5248.  
  5249.     Unbalanced quoted string on command line  . . . . . . . . . . . . .  4
  5250.  
  5251.      This error occurs when a quotation mark appears on the command
  5252.       line without a corresponding closing quotation mark.
  5253.  
  5254.      See "The USECOM Program" in the "USING A SHAREABLE COM PORT"
  5255.       section of this documentation for further details.
  5256.  
  5257.  
  5258.     Cannot understand command line option, "<option>" . . . . . . . . .  5
  5259.  
  5260.      This error occurs when a '/' or a '-' character precedes an
  5261.       entry on the command line which cannot be interpreted as a
  5262.       valid USECOM option.
  5263.  
  5264.      See "The USECOM Program" in the "USING A SHAREABLE COM PORT"
  5265.       section of this documentation for further details.
  5266.  
  5267.  
  5268.     Invalid value specified for command line option, "<option>" . . . .  6
  5269.  
  5270.     THE COMSHARE SYSTEM                                     APPENDIX  -E-   94
  5271.  
  5272.  
  5273.  
  5274.      An invalid parameter value was specified for the quoted option.
  5275.  
  5276.      See "The USECOM Program" in the "USING A SHAREABLE COM PORT"
  5277.       section of this documentation for further details.
  5278.  
  5279.  
  5280.     Invalid Com Port number: "<number>" . . . . . . . . . . . . . . . .  7
  5281.  
  5282.      This error occurs whenever the Com Port number specified on
  5283.       the command line, which is assumed to be any command line
  5284.       entry not preceded by a '/' or a '-' character, is not a
  5285.       number between 1 and 4.
  5286.  
  5287.      See "The USECOM Program" in the "USING A SHAREABLE COM PORT"
  5288.       section of this documentation for further details.
  5289.  
  5290.  
  5291.     GRAD number exceeds License in option, "<option>" . . . . . . . . .  8
  5292.  
  5293.      This error occurs when the GRAD number specified as a parameter
  5294.       value to the quoted option is a number greater than the maximum
  5295.       GRAD number allowed for by the current ComShare System License.
  5296.  
  5297.      The maximum GRAD number allowed is the same as the maximum number
  5298.       of concurrently existent GRADs allowed for by the License.
  5299.  
  5300.      See "How The ComShare System is Distributed" in the
  5301.       "INTRODUCTION" section of this documentation for further details.
  5302.  
  5303.  
  5304.     Node Registration failed  . . . . . . . . . . . . . . . . . . . . .  9
  5305.  
  5306.      For the NetBIOS version, this means that the USECOM program
  5307.       was unable to add the "machine name", which is formed from the
  5308.       NetBIOS "Adapter Status ID", to the NetBIOS network.  This
  5309.       should never happen.
  5310.  
  5311.      For the IPX/SPX version, this means that the USECOM program
  5312.       was unable to open socket number 5100 hex, which would mean
  5313.       that some other resident utility on the same machine was using
  5314.       that particular socket number at the time.
  5315.  
  5316.  
  5317.     Com Port <number> is already Open . . . . . . . . . . . . . . . . . 10
  5318.  
  5319.      An attempt was made to Open a Com Port which was already Open.
  5320.  
  5321.  
  5322.     Com Port <number> is already Closed . . . . . . . . . . . . . . . . 11
  5323.  
  5324.      An attempt was made to Close a Com Port which was not Open.
  5325.  
  5326.  
  5327.     No Com Ports are available to Open  . . . . . . . . . . . . . . . . 12
  5328.  
  5329.     THE COMSHARE SYSTEM                                     APPENDIX  -E-   95
  5330.  
  5331.  
  5332.  
  5333.      An attempt was made to Open the first available Com Port,
  5334.       but all Com Ports were already Open.
  5335.  
  5336.      If desired, the "/STATUS" command line option can be used to
  5337.       Ascertain the Status, which will reveal the current status of
  5338.       all four Com Ports.
  5339.  
  5340.  
  5341.     No Com Ports are in use - Close Request ignored . . . . . . . . . . 13
  5342.  
  5343.      An attempt was made to Close the first available Open Com
  5344.       Port, but no Com Ports were found to be Open.
  5345.  
  5346.  
  5347.     USECOM still resident - all buffers could not be released . . . . . 14
  5348.  
  5349.      This error may occur in response to a "/SHUTDOWN" request, and
  5350.       means that USECOM cannot be disabled because one or more blocks
  5351.       of another program's resident memory exists above one or more
  5352.       of USECOM's resident character buffers, preventing them from
  5353.       being released.
  5354.  
  5355.      Unlike the SHARECOM program however, the appearance of this
  5356.       error message does not imply that nothing was achieved - quite
  5357.       the opposite: All Open Com Ports were still Closed, and all
  5358.       resident memory that could be released, was released.
  5359.  
  5360.      See "Memory Considerations" in the "USING A SHAREABLE COM PORT"
  5361.       section of this documentation for further details.
  5362.  
  5363.  
  5364.     USECOM still resident - resident code could not be released . . . . 15
  5365.  
  5366.      This error may occur in response to a "/SHUTDOWN" request, and
  5367.       means that USECOM cannot be disabled because one or more blocks
  5368.       of another program's resident memory exists above the USECOM
  5369.       program's resident program code, preventing it from being
  5370.       released.
  5371.  
  5372.      Unlike the SHARECOM program however, the appearance of this
  5373.       error message does not imply that nothing was achieved - quite
  5374.       the opposite: All Open Com Ports were still Closed, and all
  5375.       resident character buffers were released.
  5376.  
  5377.      See "Memory Considerations" in the "USING A SHAREABLE COM PORT"
  5378.       section of this documentation for further details.
  5379.  
  5380.  
  5381.     Version is incompatible with Version already installed. . . . . . . 16
  5382.  
  5383.      This error occurs when the USECOM program being invoked has
  5384.       a different version number than the USECOM program currently
  5385.       resident in memory.
  5386.  
  5387.  
  5388.     Could not find an available GRAD on the Network . . . . . . . . . . 17
  5389.  
  5390.     THE COMSHARE SYSTEM                                     APPENDIX  -E-   96
  5391.  
  5392.  
  5393.  
  5394.      An attempt was made to Open a Com Port but failed because an
  5395.       available GRAD could not be found on the network matching the
  5396.       criteria either specified on, or assumed from, the command line.
  5397.  
  5398.  
  5399.     All possible buffers have already been installed  . . . . . . . . . 18
  5400.  
  5401.      This error may occur in response to a "/BUFFER" request, and
  5402.       means that the USECOM program is unable to create another
  5403.       unused resident character buffer because the maximum of four
  5404.       resident character buffers have already been installed.
  5405.  
  5406.      If desired, the "/STATUS" command line option can be used to
  5407.       Ascertain the Status, which will reveal the current status of
  5408.       all four resident character buffers.
  5409.  
  5410.  
  5411.     PICKCOM Error Messages
  5412.     ──────────────────────
  5413.  
  5414.     For the PICKCOM program, the types of errors that can be reported,
  5415.     their associated DOS return codes, and a brief explanation, are as
  5416.     follows:
  5417.  
  5418.                          PICKCOM Error Message                      DOS Return
  5419.                          ~~~~~~~~~~~~~~~~~~~~~                         Code
  5420.  
  5421.  
  5422.     DOS Version 3.1 or better is required . . . . . . . . . . . . . . .  1
  5423.  
  5424.      An attempt was made to invoke the PICKCOM program under a
  5425.       version of the DOS operating system older than version 3.1.
  5426.  
  5427.      See "Minimum System Requirements" in the "GETTING STARTED"
  5428.       section of this documentation for further details.
  5429.  
  5430.  
  5431.     <network type> is not installed . . . . . . . . . . . . . . . . . .  2
  5432.  
  5433.      This error occurs when the specified network software, either
  5434.       NETBIOS or IPX/SPX, is not installed when the PICKCOM program
  5435.       is invoked.  The network software must be installed before
  5436.       invoking PICKCOM.
  5437.  
  5438.  
  5439.     No more available memory - cannot continue . . . . . . . . . . . . . 3
  5440.  
  5441.      The PICKCOM program has run out of conventional memory to
  5442.       allocate for display purposes.  Uninstalling one or more resident
  5443.       utilities should fix the problem.
  5444.  
  5445.  
  5446.     Cannot find USECOM.COM using the current search path . . . . . . . . 4
  5447.  
  5448.     THE COMSHARE SYSTEM                                     APPENDIX  -E-   97
  5449.  
  5450.  
  5451.  
  5452.      The PICKCOM program could not locate the USECOM.COM program in
  5453.       either the current directory, or a directory specified in the
  5454.       DOS PATH environment variable, and could therefore not invoke it.
  5455.  
  5456.  
  5457.     Sharing violation occurred invoking USECOM.COM . . . . . . . . . . . 5
  5458.  
  5459.      The PICKCOM program could not invoke the USECOM program due to
  5460.       a sharing violation, which would seem to imply that, for some
  5461.       reason, either the PICKCOM program, or the User running it, does
  5462.       not have execute rights on the USECOM.COM file.
  5463.  
  5464.  
  5465.     Incompatible version of USECOM is installed  . . . . . . . . . . . . 6
  5466.  
  5467.      The PICKCOM program being used has a different version number
  5468.       than the USECOM program which is currently resident.  Since both
  5469.       programs are part of the same ComShare System, they should both
  5470.       have the same version number.  This error will only appear if
  5471.       the USECOM program was made resident prior to invoking the
  5472.       PICKCOM program.
  5473.  
  5474.  
  5475.     USECOM.COM has been corrupted  . . . . . . . . . . . . . . . . . . . 7
  5476.  
  5477.      The PICKCOM program could not invoke the USECOM program because
  5478.       the USECOM.COM file is damaged.
  5479.  
  5480.  
  5481.     Cannot invoke USECOM.COM . . . . . . . . . . . . . . . . . . . . . . 8
  5482.  
  5483.      The PICKCOM program could not invoke the USECOM program for
  5484.       reasons unknown.
  5485.  
  5486.  
  5487.     INSTALL Error Messages
  5488.     ──────────────────────
  5489.  
  5490.     For the INSTALL program, the types of errors that can be reported,
  5491.     their associated DOS return codes, and a brief explanation, are as
  5492.     follows:
  5493.  
  5494.                          INSTALL Error Message                      DOS Return
  5495.                          ~~~~~~~~~~~~~~~~~~~~~                         Code
  5496.  
  5497.  
  5498.     DOS Version 3.1 or better is required . . . . . . . . . . . . . . .  1
  5499.  
  5500.      An attempt was made to invoke the INSTALL program under a
  5501.       version of the DOS operating system older than version 3.1.
  5502.  
  5503.      See "Minimum System Requirements" in the "GETTING STARTED"
  5504.       section of this documentation for further details.
  5505.  
  5506.  
  5507.     No more available memory - cannot continue  . . . . . . . . . . . .  2
  5508.  
  5509.     THE COMSHARE SYSTEM                                     APPENDIX  -E-   98
  5510.  
  5511.  
  5512.  
  5513.      The INSTALL program has run out of conventional memory to
  5514.       allocate for display purposes.  Uninstalling one or more
  5515.       resident utilities should fix the problem.
  5516.  
  5517.  
  5518.     "INSTALL.EXE" has been corrupted  . . . . . . . . . . . . . . . . .  3
  5519.  
  5520.      Unexpected results indicate that the INSTALL.EXE file has
  5521.       been damaged since it was extracted from the ComShare System
  5522.       distribution .ZIP file.  Deleting the current INSTALL.EXE file
  5523.       and unzipping the original INSTALL.EXE file from the ComShare
  5524.       System distribution .ZIP file should fix the problem.
  5525.  
  5526.